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Preface 


This publication is a quick reference for all users of VM/SP, from 
general users to experienced system programmers. It is the one 
book in the VM/SP library that contains all the commands (CP, CMS, 
GCS, TSAF, IPCS, and RSCS) that are documented in the rest of the 
library. The coverage is complete so that experienced programmers 
can find infrequently used command formats, such as privileged CP 
commands, without delving into the entire library. Since all 
commands are clearly labeled, each type of user can quickly find the 
particular one he needs and ignore the others. The addition of an 
index and running headings make this an easy task. 

New users who need more guidance will find the VM/SP CMS Primer 
and the VM/SP CMS Primer for Line-Oriented Terminals most 
helpful. These primers give you detailed, easy-to-follow directions 
on how to do your work using the VM/SP system. 

The section “Using VM/SP System” is a memory jogger describing 
how to access the VM/SP system and control terminal operations, 
how to create files and manipulate data, and how to code and debug 
programs using CMS. 

The section “Summary of VM/SP Commands” is an alphameric 
listing of all the VM/SP commands and service aids. For each 
command a brief description of its function is included, as well as the 
complete command format. The section also describes the syntax 
conventions used in the command formats and summarizes the CP 
privilege classes. 

This publication is part of a set of reference summaries that may be 
ordered as a group under Order No. SBOF3242. 
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Terminology 


The user privilege classes referred to throughout this book are 
IBM-defined classes. If your installation restructures the classes, 
see your installation administrator. 


Using This Publication 

This publication includes commands and operands that pertain to the 
VM/SP System Control Program (5664-167). 

See the Bibliography for lists of the VM/SP publications that should 
be used in conjunction with the first sections of this publication. 
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Chapter 1. Using the VM/SP System 


IBM Virtual Machine/System Product (VM/SP) is a system control 
program that controls virtual machines. A virtual machine is a 
functional equivalent of a real machine that you control from your 
terminal using a command language. VM/SP builds and maintains, 
for each user, a virtual System/370 machine from a predefined 
configuration. 

The virtual machine configuration includes components 
corresponding to a real System/370: 

1. A virtual operator's console 

2. Virtual storage 

3. A virtual processor 

4. Virtual channels and I/O devices. 

However, since the virtual machines are simulated, their 
configurations may differ from that of the real machine and from 
each other. For example, the real machine may have 512K bytes of 
real storage and eight real disk drives, while a virtual machine may 
have 768K bytes of virtual storage and two virtual disk drives. 

The command languages correspond to the components of VM/SP. 
CP (Control Program) controls the virtual machine while CMS 
(Conversational Monitor System) is the conversational operating 
system designed to run under CP. You use CP commands to 
communicate with the Control Program and control the devices 
attached to your virtual machine. CP commands can be entered 
from either the CP or CMS environment; but CMS commands cannot 
be entered while in the CP environment. Thus, the CP and CMS 
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command languages are, for practical purposes, a single, integrated 
command language for CMS users. 

VM/SP makes work easier with its ability to create, change, store, 
copy, send and print data files. 

New users will find the VM/SP CMS Primer most helpful. It teaches 
you how to do your work using the VM/SP system and a video 
display terminal. Likewise, the CMS Primer for Line-Oriented 
Terminals is for new users who have line-oriented terminals. 


Getting Started 

Before you can start using VM/SP, you must have: 

• A user identification and password. Your user identification 
(userid) identifies you to VM/SP. Your password is checked 
when you log on, and protects your virtual machine from 
unauthorized use. The VM/SP system operations group usually 
assigns userids and passwords. 

• A virtual machine defined for your use. The virtual machine 
definition should include all the devices you expect to use, for 
example: 

A console 
Card reader 
Card punch 
Printer 
Disk space. 

The VM/SP system operations group usually defines your virtual 
machine configuration. 
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• Properly formatted disk space. The VM/SP system operations 
group usually formats disk space, but you can format your own 
disk space using the FORMAT command. See the VM/SP CMS 
User's Guide for details on formatting your disk space. 

Once you have your userid and password, you can communicate 
with the VM/SP system from a terminal such as an IBM 3270 
Information Display System Terminal, IBM 2741 typewriter-like 
terminal, or IBM 1050 Data Communication System (or equivalent). 
Depending on your terminal, you can either dial the central VM/SP 
computer, or you are directly connected to it. For a description of 
the communication procedures for each type of terminal, see the 
VM/SP Terminal Reference. 


Terminal Operating Procedures 

For a more detailed description of specific terminal models with their 
specific messages, see the VM/SP Terminal Reference. 


Logging On 

First, establish communication with VM/SP by turning on your 
terminal's power. VM/SP sends a Virtual Machine/System Product 
message and/or logo to your terminal. 

Note: If your terminal is not a 3270-type, use the logon procedure 
outlined in the Logon Exceptions section. 

If your terminal is a 3270-type, with a screen size of 20x80 or larger, 
you may log on directly from the logo screen. 
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Below the actual VM/SP logo you will find instructions for filling in 
your userid and password. For security reasons, your password will 
not appear when you enter it. 

Three input lines follow the instructions and are labeled USERID, 
PASSWORD, and COMMAND. The cursor is placed at the input line 
for USERID. 

You may type your userid and password in the USERID and 
PASSWORD input areas and press enter. If all the information is 
entered correctly, the logo is cleared from the screen, no further 
prompts will appear, and you will be logged on to the system. If an 
invalid userid or password is entered, the logo is cleared from the 
screen, and the following message and prompt will appear: 

DMKLOG050E LOGON unsuccessful - incorrect password 


or 

DMKL0G053E userid not in CP directory 

Enter one of the following commands: 

LOGON userid (Example: LOGON VMUSER1) 

DIAL userid (Example: DIAL VMUSER2) 

MSG userid message (Example: MSG VMUSER GOOD MORNING) 

LOGOFF 

If you enter only your PASSWORD in the input area or if your 
USERID, as entered, contains one or more blanks (V MUSER1), the 
following error will be issued, followed by the LOGON prompts: 

DMKLOG050E userid not in CP directory 

Enter password (It will not appear when typed) s 


You may also enter your userid in the USERID input area without 
your password or enter the LOGON command, followed by your 
userid, in the COMMAND input area. The following prompt will 
appear: 
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Enter password (It will not appear when typed) : 


If you have entered the information correctly, the logo is cleared 
from the screen and you will be logged on to the system. 
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I Logon Exceptions 


If your terminal is not a 3270-type terminal, use the following logon 
procedures once you have established communication with VM/SP. 

Press the Enter key (or Clear key, or Attn key, or equivalent). Then 
the system prompts you: 

Enter one of the following commands: 

LOGON userid (Example: LOGON VMUSER) 

DIAL userid (Example: DIAL VMUSER2) 

MSG userid message (Example: MSG VMUSER2 GOOD MORNING) 

LOGOFF 

Identify yourself to the system by entering one of the above choices. 
For example: 

1 userid (short for LOGON userid) 

Then press the Enter (or Return) key. 

If VM/SP accepts your userid, it responds with: 

Enter password (it will not appear when typed): 


Then type your password and press the Enter key. Each time you 
press Enter the command you typed is sent to the system. 

Note: Not seeing your password as you type it is a security measure 
that prevents other people from learning your password and using 
your system without authorization. For more information on this 
masking technique or using the print inhibiting feature, see the 
VM/SP Terminal Reference. 

If you make an error during the logon procedure the system will give 
you an error message and you must start the logon procedure from 
the beginning by entering “I userid” again. 
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For example, if you type your password incorrectly VM/SP will give 
you this error message: 

DMKLOG050E LOGON unsuccessful—incorrect password 
Enter one of the following commands: . 


Or if the userid and password you enter are valid, but someone else 
has already logged on with this userid, VM/SP issues this message: 

DMKLOG054E Already logged on devtype rdev 
Enter one of the following commands: . 


If you want to find out why the userid you just entered is in use, issue 
the MSG command to send a message to the operator or to the other 
user. You should either logon with another userid (if another userid 
is reserved for your use) or try again later. 

If you are currently logged on when you issue an invalid command, 
you will receive the message: 

Unknown CP command: name 


Once you have successfully logged on and entered the system, 

VM/SP replies with the following kinds of messages: 

• Informational messages regarding linkage status of minidisks 
attached to your virtual machine 

• LOGMSG setup time (the time and date that the operator created 
a log message) 

• The log message line that the operator created 

• The FILES message (which tells you if you have any virtual 
reader, print, or punch files) 

• A LOGON message, such as: 


Chapter 1. Using the VM/SP System 7 





LOGON AT 11:24:35 EST THURSDAY ram/dd/yy 


Now you can start using the virtual machine that you have set up for 
your userid. 


Logging Off 

When you want to end your terminal session, you do so by logging 
off the VM/SP control program (CP). Even if you are in CMS mode, 
you need only enter the command: 

log (short for LOGOFF) 

and press the ENTER key. VM/SP responds with: 

CONNECT=hh:mm:ss VIRTCPU=mmm:ss.ss TOTCPU=mmm:ss.ss 
LOGOFF AT hh:mm:ss zzz weekday mm/dd/yy 


and the connection with VM/SP terminates. The connect time is in 
hours, minutes, and seconds. The system displays the use of the 
virtual processor and total processor in minutes, seconds, and 
hundreths of a second. Pressing the appropriate key on your 
terminal causes the logo to appear on the terminal in preparation for 
the next session. Only when the logoff procedure is completed 
should you turn off terminal power. 

Note: If you logged off over a dialed line, you may specify that the 
communication line be left connected so that another user can logon 
immediately from the same terminal. When you issue: 

log hold (short for LOGOFF HOLD) 

the next user can then logon to VM/SP without having to reestablish 
a line connection. 
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Disconnecting Your Terminal 


There are situations when it is to your advantage to disconnect your 
terminal from your virtual machine. 

The disconnect function is described in VM/SP Terminal Reference 
and the CP Command Reference. 


Logoff and Security 

When telecommunication line failures affect the system, VM/SP 
places your virtual machine in a DISCONNECT status for 15 minutes 
before it automatically logs you off the system. 

If you turn off your terminal instead of issuing the LOGOFF 
command, your virtual machine is still logged on until: 

• CP attempts to write data to your terminal while it is turned off, or 

• Your terminal is turned on again. 

If this happens, VM/SP places your virtual machine in DISCONNECT 
status for 15 minutes (unless you reconnect), and then logs you off 
the system. Even if another user turns on the same terminal he 
cannot use your virtual machine; he must log on using his own 
userid. Your virtual machine can be reconnected only by the normal 
logon procedure, requiring your password identification. 

Note: The same sequence of events occurs: 

• If your terminal is physically disconnected from the control unit, 
or 

• If, on some terminals, the security key is turned to the locked 
position and then turned back to the unlocked position, or 
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• When, on some display terminals, the unit is switched to TEST 
mode and then back. 


Input Conventions 

You may enter data in either uppercase or lowercase. The examples 
in this book use lowercase characters for user entries and 
uppercase characters for system responses. 

To correct typing errors on a full screen display terminal you can 
simply type over the data or use the Delete key for character 
deletion. 

To correct typing errors in entering commands on a line-editing 
terminal, VM/SP assigns logical line-editing functions to four special 
characters. These characters allow you to easily correct mistakes 
as you enter data. 


Using Logical Line Editing Characters 

If you make a typing error when entering a command on a 
line-editing terminal, you can correct it by using one of four special 
characters. These four "logical line-editing” characters are more 
useful with typewriter-like terminals, (which do not have 
cursor-controlled line-editing) than with display terminals, but are 
valid for use with both. The characters listed in Figure 1 are the 
default characters in the system. They can be changed to others if 
your terminal keyboard does not have these characters. You can 
define some other infrequently used keyboard character to perform 
these editing functions, by using the CP TERMINAL command. For 
details on using the CP TERMINAL command to change default 
values, see VM/SP CP Command Reference. 
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Character 

Function 

Usage and Result Obtained 

@ 

Logical Character 

Delete 

deletes the preceding 
character(s). 

abc#@@ results in ab 
abc@d results in abd 

C@def results in def 

abc@@@ deletes the whole line 

# 

Logical Line End 

divides a single physical 
input line into several 
logical input lines. 

down l#type l#top 

results in execution of the commands 
as though entered: 

down 1 
type 1 
top 

0 

Logical Line Delete 

deletes the preceding 
logical input line. 

abcC results in 

abc#def£ results in abc 

abc#def#C results in abc 

def 

abc#def#Cghi results in abc 

defghi 

Note: The logical line delete symbol (C) deletes all typed 
characters back to and including the previous logical line end 
symbol (#). Use the logical line delete symbol when you 
have made several errors in a line. 


Logical Escape 

accepts the following 
#. or C character as 
data, not as a logical 
line-editing character. 

abc"Cd results in abcCd 
,,,, abc ,, " results in "abc" 

Note: The editor ignores any quotation mark (") that appears 
as the last character of a line. 


Figure 1. VM/SP Default Logical Line Editing Characters and Their Use 

Line Length 

For all VM/SP commands, input line length is restricted by the 
physical limitations of the terminal device, or by the default record 
length. Lines exceeding the maximum number of characters 
(including blanks, backspaces, underscores, the line-editing 
characters, and the tab character) are truncated to that line length 
value. 

Line Termination 

An input data line from an IBM 2741 Communications Terminal is 
transmitted to the processor by pressing the Return key. The same 
function is performed on the 3270 Information Display System 
Terminal by pressing the Enter key. Other terminals have similar 
line termination keys. As you do work on your terminal, the lower 
right corner of the screen will display various status notices. This 
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tells you what is happening in the system at the present time. This 
figure shows you how to change the status. 


if the 
initial 

Status 

was: 

and you 
pressed 

(any data 
or a 

command)? 

VM/SP does this: 

and the 

Status 

becomes: 

RUNNING 

ENiER 

no 

Enters console function mode. 

VM 

READ 

(CP mode) 


yes 

Processes console function 

RUNNING 


CANCEL 

don't care 

Clears the Output Area 

RUNNING 

RUNNING 

ENTER 

no 

Attention pending. VM running. 

RUNNING 1 

(VM mode) 


yes 

Attention pending. VM running, data stacked. 

RUNNING 2 


CANCEL 

don't care 

Clears the Output Area. 

RUNNING 2 

MORE... 

ENTER 

no 

Holds the Output Area display, 

HOLDING 



yes 

Same as for RUNNING (in CP or VM mode). 

MORE... 


CANCEL 

don't care 

Clears the Output Area, continues output. 

RUNNING 

HOLDING 

ENTER 

no 

Holds the Output Area display 

MORE... 



yes 

Same as for RUNNING (in CP or VM mode). 

HOLDING 


CANCEL 

don't care 

Clears the Output Area, continues output. 

RUNNING 3 

CP READ 

ENTER 

no 

'Null'' line return. 

RUNNING 4 



yes 

Reacs the data or command. 

RUNNING 


CANCEL 

don't care 

Clears the Output Area. 

CP READ 

VM READ 

ENTER 

no 

"Nul " line. VM continues running 

RUNNING 5 


I 

yes 

Reads data or command. VM continues 
running 

RUNNING 


CANCEL 

don't care 

Clears the Output Area If APL is on. 
interrupts the virtual machine 

VM 

READ 


Notes: 

1 The status shown is RUNNING, however, the virtual machine should respond to the ATTN with a read, 
whereupon the status goes to VM RfcAD 

1 If a data buffer is already stacked for a virtual machine, the terminal displays NOT ACCEPTED status before 
returning to the RUNNING status 

Figure 2 (Part 1 of 2). Summary of Status Action on Display Terminals 
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3 If you are running with TERMINAL MODE CP (the default for the primary system operator), an attention 
return also occurs that cancels the function. You can use this to terminate certain QUERY or DISPLAY 
functions on consoles that do not have a PA1 key. 

4 Unless you are the VM/SP primary system operator or are running with the SET RUN ON option, the status 
returns to CP READ for another console function if the previous read was for a console function. 

5 The status remains VM READ if you have SET AUTOREAD ON 


Figure 2 (Part 2 of 2). Summary of Status Action on Display Terminals 
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Chapter 2. Using CMS 


The CMS (Conversational Monitor System) component of VM/SP 
allows you to create, compile, execute and test programs, and to 
create and manage data files. 

Before you can use CMS, you must do the following: 

• Logon with a valid user identification and password. The user 
identification should have a virtual machine defined for its use. 

• Initial program load (IPL) the CMS system by specifying the name 
of the CMS system or the device address of the CMS system disk. 

• Have disk space available that is formatted for use by CMS. 

The logging on procedure is discussed in “Terminal Operating 
Procedures” on page 3. The IPL procedure is described in this 
section. Disk formatting is detailed in the VM/SP CMS User's Guide. 
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HowTo Initial Program Load (IPL) CMS 


If your system does not have "automatic IPL,” you need to load CMS 
into your virtual machine by entering a command. Type: 

ip 1 cms 
- or - 
ipl 190 

Press enter. VM/SP responds with a ready message which usually 
looks like: 

Ready; T=7.36/19.87 09:26:12 

If you have properly formatted disk space available you can now use 
the facilities of CMS: 


System Product Editor 

The part of the VM/SP system that helps you manipulate files is 
called the System Product Editor, invoked by the XEDIT command. 
Its enhancements include: 

• Full screen editing 

• Multiple views of the same file 

• Multiple files viewed on the same screen 

• Addition of color and extended highlighting 

• Ability to issue selected commands directly from the displayed 
line 
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Ability to define screen formats with flexibility, including splitting 
the screen vertically 


• Extended use of the prefix area 

• Extended string search to facilitate text processing 

• Column pointer for intraline-editing 

• Line splitting and/or joining functions 

• Macro writing capabilities to expand the basic subcommand 
language and to tailor the language to your own application. 

For a thorough understanding of the System Product Editor and its 
diverse uses, see VM/SP System Product Editor User's Guide and 
VM/SP System Product Editor Command and Macro Reference. 


EXEC 2 Interpreter 

An EXEC is a CMS function that allows you to create new commands 
by setting up frequently used CP or CMS commands, together with 
conditional branching facilities. This eliminates the repetitious 
re-keying of those commands. The sequence of commands is 
executed when you enter the filename of the EXEC. Coexisting with 
the EXEC processor currently in use, the EXEC 2 interpreter 
features: 

• Acceptance of 255-character words 

• Issuance of commands to either CMS or to specified other 
subcommand environments 

• String manipulation functions 
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• Arithmetic functions such as multiplication and division 

• Debugging facilities 

• Support for user-defined functions and subroutines. 

For a thorough understanding of the system product EXEC 2 
interpreter, see VM/SP EXEC 2 Reference. 


System Product Interpreter 

The System Product Interpreter is an interpretive command and 
macro processor. Everyone, from experienced programmers to 
novices, may use the System Product Interpreter to create and 
execute EXEC-type command procedures and programs. It is easy 
to learn and use. EXEC procedures allow you to create new 
commands by setting up frequently used commands, together with 
conditional branching, to eliminate the repetitious re-keying of those 
commands. The System Product Interpreter's functions are written 
in a high-level language, similar to PL/I, known as the Restructured 
Extended Executor (REXX) language. 

Some advantages of using the System Product Interpreter are that it: 

• Uses a general-purpose high-level language, REXX. 

• Supports structured programming concepts. 

• Has many built-in functions. 

• Accepts programs written in mixed case (which makes them 
easier to read). 

• Has extensive mathematical capabilities, such as decimal, 
exponential, and scientific arithmetic. 
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• Uses a full set of arithmetic, character, and logical operators with 
algebraic precedence and parentheses. 

• Accepts programs in free format. 

• Makes XEDIT macros and system EXECs easier to maintain. It 
easily handles subroutine calls to other EXECs, modules, or 
internal routines. 

The System Product Interpreter coexists with the CMS EXEC and 
EXEC 2 processors. It is functionally a superset of CMS EXEC and 
EXEC 2, but uses a completely different language and syntax. 

You can find complete information about the System Product 
Interpreter and REXX in the VM/SP System Product Interpreter 
User's Guide and VM/SP System Product Interpreter Reference. 


I CMS Session Services 

I This support improves the usability of VM/SP on 3270-type display 

I terminals. It includes: 

I 1. Window functions for the CMS user 

I 2. Full-screen CMS 

I The support also provides functions for: 

| • Defining and deleting windows 

I • Positioning windows anywhere on the screen 

I • Overlaying one window with another 

I • Scrolling backward and forward through data in a window 
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• Changing color, highlighting, and other characteristics of virtual 
screens 

• Writing data into virtual screens 

• Logging data in a CMS file 

Full-screen CMS has the following characteristics: 

• Routing VM output and messages to the appropriate windows 

• Using extended highlighting for CMS output 

• Defining CMS PF keys 

• Controlling the display of messages 

You can find complete information on this support and its functions 
in the VM/SP CMS User's Guide and the VM/SP CMS Command 
Reference. 
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Enhanced Connectivity Facilities on VM/SP 

Enhanced Connectivity Facilities on VM/SP is part of IBM System/370 
to IBM Personal Computer Enhanced Connectivity Facilities. 
Enhanced Connectivity Facilities on VM/SP provides: 

• A means for VM/SP to communicate with your work station (for 
example, IBM Personal Computer). 

With a communications program running on your work station, 
you can enter the CMS command, CMSSERV, to start 
communications between VM/SP and your work station. With 
this, you have access to the services of the IBM System/370 to 
IBM Personal Computer Enhanced Connectivity Facilities. 

• The Server-Requester Programming Interface (SRPI). 

If you're an application programmer, you can write server 
programs for VM/SP that use the SRPI. A companion requester 
program, typically on the work station, can then ask the server to 
perform needed functions on VM/SP and pass the results back to 
the requester. 

The SRPI has five subcommands (ADDENTRY, DELENTRY, 
GETREQ, SENDREQ, and SETREPLY) that you can use when 
writing server programs. 

You can find more information on how you can use the services of 
the IBM System/370 to IBM Personal Computer Enhanced 
Connectivity Facilities in the VM/SP Introduction or the Introduction 
to IBM System/370 to IBM Personal Computer Enhanced Connectivity 
Facilities, GC23-0957. If you are an application programmer and 
want to learn more about writing “servers,” see the VM/SP 
Programmer’s Guide to the Server-Requester Programming Interface 
for VM/SP. 
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Example of CMS Program Development Facilities 


This section illustrates several CMS functions that are useful in 
creating and manipulating CMS files. For detailed descriptions for 
developing application programs, see the Application Development 
Guide. 


Creating an Assembler Language Source File 

The sample program that follows is an Assembler language program 
that reads data from one CMS file and writes it to another CMS file. 
After you have logged on the system and issued IPL CMS, you can 
create the program using the CMS XEDIT facility. 
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xedit manip assemble 
CREATING NEW FILE: 
input 
INPUT: 

MANIP CSECT 

PRINT NOGEN 
SAVE (14,12),,* 

BALR 12,0 

USING *,12 ESTABLISH ADDRESSABILITY 

LA 2,8 (, 1) R2 =S ADDR OF INPUT FILE IN PLIST 

LA 3,32(,1) R3«ADDR OF OUTPUT FILE IN PLIST 

* DETERMINE IF INPUT FILE EXISTS 

FSSTATE (2),ERROR=ERRl 

* READ A RECORD FROM INPUT FILE AND WRITE ON OUTPUT FILE 

RD FSREAD (2) , ERROR=EOF, BUFFER=BUFF1, BSIZE=*80 

FSWRITE (3),ERROR=ERR2,BUFFER=BUFF1,BSIZE=80 
B RD LOOP BACK FOR NEXT RECORD 

* COME HERE IF ERROR READING INPUT FILE 

EOF EQU * 

LA 15,7 TEST CODE FOR READ ERROR 

C 15,=F'12' END OF FILE? 

BNE ERR3 ERROR IF NOT 

RETURN (14,12),RC=0 

* IF INPUT FILE DOES NOT EXIST 

ERR1 WRTERM 'FILE NOT FOUND',EIDT=YES 

B ERRET 

* IF ERROR WRITING FILE 

ERR2 LINEDIT TEXT='ERROR CODE . IN WRITING FILE', $ 

SUB=(DEC,(15)) 

B ERRT 

* IF READING ERROR WAS NOT NORMAL END OF FILE 

ERR3 LINEDIT TEXT='ERROR CODE . IN READING FILE', $ 

SUB=(DEC,(15)) 

ERRET RETURN (14,12),RC«1 RETURN TO CALLER 

BUFFI DS CL80 
END MANIP 

(Press the ENTER/RETURN key to leave Input mode.) 

(Remember that the continuation character '$' must be in 
in column 72) 

XEDIT: 
file 
Ready; 


Figure 3. Sample Assembler Language Program Used for Creating a Source File 


Chapter 2. Using CMS 23 







The Editor (the term applied to the edit program that is used by the 
XEDIT command) did not find a file with the filename and filetype of 
MANIP ASSEMBLE, so it created the file for you. Enter the INPUT 
subcommand so that you can enter your program code into the file. 
You must issue the FILE subcommand to save your program. 

This program (MANIP CSECT) uses several CMS macros; when it is 
assembled, this program requires the CMS macro library. To 
identify the macro libraries to be searched, issue: 

global maclib dmssp tsomac cmslib osmacro 


Assembling a Source File 

To assemble the MANIP program, you enter the “ASSEMBLE 
MANIP" command, then wait for the assembler to complete 
processing. The assembler expects to find a CMS file with the 
filetype ASSEMBLE. 

assemble manip 


ASSEMBLER (XF) DONE 

MAN00331 B ERRT 

IF0024 NEAR OPERAND COLUMN 1-UNDEF SYMBOL 

1 STATEMENT FLAGGED IN THIS ASSEMBLY 
8 WAS HIGHEST SEVERITY CODE 
Ready (00008); 

The message IFO024 indicates an error in your program. The line in 
your program containing the error has a sequence number of 
MAN00331. Display or print your listing file to find this line. 

At this point, three files are associated with your program: 

1. The MANIP ASSEMBLE file contains the source statements of 
your program. This file was the input used by the Assembler 
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Language program. The output from the assembler is two 
permanent files, MANIP TEXT and MANIP LISTING. 

2. The MANIP TEXT file contains the object module. 

3. The MANIP LISTING file contains a listing of the source 
statements, assembled machine code, and other associated 
information based on the options selected for the ASSEMBLE 
command. 


Correcting Errors 

Since the assembler has detected an error in the source code, you 
must correct the error before attempting to execute the program. 

Just as you used the editor to create the assembler file, you also use 
the editor (either the CMS Editor or the System Product Editor 
(XEDIT)) to change or correct the assembler file. When you issue the 
XEDIT MANIP ASSEMBLE command this time, the editor finds your 
file and enters edit mode. Then issue the LOCATE subcommand to 
find the line in error. Issue the CHANGE subcommand to correct the 
error and then issue FILE to save the corrected program. The 
terminal output is as follows: 

xedit manip assemble 
XEDIT: 

locate /errt/ 

B ERRT 

change /errt/erret/ 

B ERRET 

file 
Ready; 


Now that the error has been corrected, you can assemble the file 
again: 

assemble manip 
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ASSEMBLER (XF) DONE 


NO STATEMENTS FLAGGED IN THIS ASSEMBLY 
Ready; 


This time, the program assembled without any assembler-detected 
errors. The TEXT and LISTING files from the previous assembly are 
erased automatically and replaced by the new ones from the current 
assembly. 


Creating a Load Module 

You can now create a load module from the TEXT file that was 
created by the assembler. The resulting MODULE file can then be 
executed. 

load manip 
Ready; 

genmod manip 
Ready; 


Now a fourth file, MANIP MODULE, exists. This file is in executable 
form. 


Testing and Correcting a Program 

Once the MODULE file has been created, you can begin testing. To 
execute the MANIP MODULE file, issue the MANIP command name, 
plus the file identifiers for the input and output files. The input file 
(MANIP ASSEMBLE A1) is to be copied and the resulting file is to be 
called MANIP1 ASSEMBLE A1. The first test should take the branch 
on the FSREAD error. The following error message appears on the 
terminal: 
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manip manip assemble al manipl assemble al 
ERROR CODE 7 IN READING FILE. 

Ready (00001); 


You should then use the Editor to correct the program so that this 
branch is no longer taken. 

xedit manip assemble 

XEDIT: 

find eof 

EOF EQU * 

next 

LA 15,7 TEST CODE FOR READ ERROR 
delete 
f ile 
Ready; 


After the corrected version of the program is filed, assemble and 
execute the program again. 

assemble manip 
ASSEMBLER (XF) DONE 

NO STATEMENTS FLAGGED IN THIS ASSEMBLY 
Ready; 

load manip 
Ready; 

genmod manip 
Ready; 


This command produces a file called “MANIP MODULE.” 

Now that the testing statement has been deleted, and a new 
MODULE file created, further testing of the program can begin. First, 
attempt to copy a file that does not exist. The file is not found. 

manip filel assemble al file2 assemble al 
FILE NOT FOUND 
Ready (00001); 
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Then, attempt to copy a file to itself. Your program is not equipped 
to do this; an error occurs. 

manip manip assemble al manip assemble al 
ERROR CODE 9 IN WRITING FILE. 

Ready (00001); 

Finally, create a new file (MANIP1) from your MANIP file. 

manip manip assemble al manipl assemble al 
Ready; 


Erasing Unwanted Files 

Once testing is complete, display the beginning of MANIP1 to make 
sure that it was copied correctly, then delete the MANIP1 file: 

type manipl assemble 1 5 

MANIP CSECT 

PRINT NOGEN 

SAVE (14,12),,* 

BALR 12,0 

USING *,12 ESTABLISH ADDRESSABILITY 


Ready; 


erase manipl assemble 
Ready; 


Or type DISCARD in the "Cmd” space next to the file you no longer 
want from the FILELIST screen. Then press the Enter key to execute 
it. 

The LISTFILE or FILELIST command can then be issued to make sure 
the file was erased: 


listfile * assemble 
MANIP ASSEMBLE Al 
Ready; 
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CMS File System 


Printing, Sending, and Reading Files 


Printing Files 

When you want to print your program listing, you should first check 
the output status of your virtual printer by entering: 


query OOe 

PRT OOE CL A NOCONT NOHOLD COPY 01 READY FORK FORM 

OOE FOR USERID DIST distcode FLASHC 000 DEST OFF 
OOE FLASH CHAR MDFY FCB 

Ready; 


Since output class A is acceptable for program listings, print the 
LISTING file: 


print manip listing 
Ready; 


You can also print the LISTING file by specifying the PRINT option 
when you issue the ASSEMBLE command. Once the LISTING file is 
printed, it can be erased. Also, you may want to erase the TEXT file 
from which the MODULE file was generated: 

erase manip listing 
Ready; 

erase manip text 
Ready; 
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Sending Files 


If other users want to use your MANIP program, send it to them by 
using the SENDFILE command. Type SENDFILE, and a screen for 
data entry is displayed. Then type the name of the file to be sent and 
the name of the recipient, directly on the screen. You can also 
select certain options from the list on the screen by answering YES 
or NO. Press PF5 to send the file and exit from the sendfile screen. 
Pressing the ENTER key sends the file but keeps the screen (so that 
you can use it to send another file). 


Reading Files 

When the user PAYROLL logs on the VM/SP system, the following 
message types during the logon procedure: 

FILES: 001 RDR, NO PRT, NO PUN 

The PAYROLL user can decide whether or not he wants the file 
before he reads it by invoking the command: 

query reader all 

ORIGINID FILE CLASS RECORDS CPY HOLD DATE TIME NAME TYPE DIST 

NET4 1014 A PUN 0000051 001 NONE 08/17 12:36:03 MANIP TEXT G41/ 

To read in this file, the PAYROLL user must IPL CMS and issue the 
command: 

RECEIVE 

Or issue 

READ * 

READ CONTROL CARD MISSING. FOLLOWING ASSUMED:. 

:READ READCARD CMSUT1 A1 
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CMS reads the first spool reader file in the queue and if there are 
READ control cards in the input stream, it names the files as 
indicated on the control cards. 

The first card in the deck may not be a READ control card. If it isn't, 
CMS writes a file named READCARD CMSUT1 A1 to contain the 
data, until a READ control card is encountered or until the end-of-file 
is reached. 

If there is only one file in the reader and you use the READ * 
command, the file is moved to your A-disk and is named READCARD 
CMSUT1 A1. 

If there is more than one file in the reader and you use the READ * 
command to read a second file, the second file is moved to your 
A-disk and replaces the first file. You can save the first file simply by 
renaming the READCARD CMSUT1 A1 file before you use the READ * 
again to read in additional files. 

The RECEIVE command does not read in the first file and then 
replace the previous file with each successive use of the command. 
Instead, the RECEIVE command receives the file and moves it to 
your A-disk. 

If the PAYROLL user does not want the file, he can purge it from his 
reader, as follows: 

purge reader (or purge reader 1014) 

0001 FILE PURGED 

Or issue the RDRLIST command to display information about files in 
your reader. Then choose to receive, discard, replace, rename, or 
peek at the file from the “Cmd” space. 

CMS can be used for many other purposes. Those functions 
illustrated in the previous discussion are intended to help VM/SP 
users become acquainted with the system and its capabilities. Once 
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you are familiar with these commands and functions, you have a 
sound base upon which to build a more thorough understanding of 
the VM/SP system. 


CMS Fileids 

The CMS file is the essential unit of data in the CMS system. When 
you create a file in CMS, you name it using a file identifier (fileid). 

A fileid consists of: 

filename filetype filemode. 

The fileid is associated with a particular file when the file is created, 
defined or renamed under CMS. 

A valid filename consists of a 1- 8-character alphameric field, 
comprised of A-Z, a-z, 0-9. and special characters $ # @ + - 
(hyphen): (colon) _ (underscore), that is part of the CMS file 
identifier and serves to identify the file for the user. 

A valid filetype consists of a 1- 8-character alphameric field, 
comprised of A-Z, a-z, 0-9. and special characters $ # @ + - 
(hyphen): (colon) _ (underscore), that is part of the CMS file 
identifier and serves to identify the file for the user. 

A valid filemode is a 2-character CMS file identifier field comprising 
the filemode letter (A through Z) followed by the filemode number ( 0 
through 6). The filemode letter indicates the CMS file directory on 
which the file resides and whether or not the disk is a user virtual 
disk or a CMS system disk. The filemode number indicates the 
access mode of the disk. 
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Filemode 0 Makes that file private. No other users may access it 
unless they have read/write access to your disk. 

Filemode 1 Most common for reading and writing 

Filemode 2 Essentially the same as filemode 1. Usually is assigned 
to files that are shared by users who are linked to a 
common disk, like the system disk. 

Filemode 3 Erased after it is read. A filemode of 3 should not be 

used with EXECs (it may be erased before it completes 
execution). 

Filemode 4 OS simulated data set format, created by OS macros in 
programs running in CMS. 

Filemode 5 Essentially the same as filemode 1 for reading and 

writing. Used to maintain logical groups so that you can 
manipulate them easily in groups. 

Filemode 6 Indicates that the “update-in-place" attribute of a CMS 

file is in effect. This means that the existing records of a 
file are written back to their previous location on disk 
rather than in a new slot. This only applies to files 
located on 512-, 1K-, 2K-, or 4K-byte block formatted 
minidisks. 

For more information see the VM/SP CMS User's Guide. 
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Reserved Filetype Descriptions 


The following figure lists the filetypes used by CMS and CMS/DOS 
commands. 

In addition to these CMS filetypes, there are special filetypes 
reserved for use by the language processors, which are IBM 
program products. For details, consult the appropriate program 
product manuals. 


Filetype 

Command 

Usage 

Filename 

Format 

RECFM LRECL 

Contents 

AMSERV 

AMSERV 

Input 

fn 

F 80 

Input control statements for 
Access Method Services 

ASM3705 

ASM3705 

GEN3705 

Input 

Output 

fn fn(nn) 

F 80 

F 80 

3704/3705 assembler 
source statements 

ASSEMBLE 

ASSEMBLE 

Input 

fn 

F 80 

Assembler language source 
statements 

AUXxxxx 

UPDATE 

XEDIT 

Input 

fn 

F 80 

Auxiliary update file 

BASDATA 

BASIC 

execution 

Execution 
time files 

fn 

V 255 

User input and output files 

BASIC 

BASIC 

Input 

fn 

V 156 

BASIC language source 
statements 

CMSUT1 

READCARD 
COPYFILE 
DISK LOAD 
TAPE 

LOAD 

UPDATE 

INCLUDE 

LOAD 

MACUB 

EDIT 

XEDIT 

Intermediate 
work files 

READCARD 

COPYFILE 

DISK TAPE 
fn 

DMSLDR 

DMSLDR 

DMSLBM 

EDIT XEDIT 

F 80 


CNTRL 

UPDATE 

XEDIT 

Input 

fn 

F 80 

Control file update 

COBOL 

COBOL 

Input 

fn 

F 80 

COBOL source statements 

COPY 

MACUB 

SSERV 

Input 

Output 

fn 

fn 


COPY control cards and 
macro definitions 

A book from a DOS/VS 
source library 

DIRECT 

DIRECT 

Input 

fn 

O 

GO 

U. 

User directory entries 


Figure 4 (Part 1 of 5). Reserved Filetypes 
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Filetype 

Command 

Usage 

Filename 

Format 

RECFM LRECL 

Contents 

DOSLIB 

DOSLIB 

DOSLKED 

FETCH 

GLOBAL 

Input 

Input 

Output 

Input 

fn 

fn 

fn 

fn 

V 

1024 

CMS/DOS phase library 

DOSLNK 

DOSLKED 

Input 

fn 

F 


Linkage editor control 
statements for input to 
CMS/DOS linkage editor 

ESERV 

ESERV 

Input 

fn 

F 

80 

Input control statements for 
ESERV program 

EXEC 

EXEC 

EXEC2 

REXX 

LISTFILE 

GEN3705 

LISTIO 

Input 

Input 

Input 

Output 

Output 

Output 

fn 

fn 

fn 

CMS 

fn 

$LISTIO 


H9 

EXEC statements 

EXPAND 

EXPAND 

Input 

fn 


Control records that expand 
object files 

FORTRAN 

FORTGI 

FORTHX 

GOFORT 

TESTFORT 

Input 

fn 

V 

80 

FORTRAN source 
statements 

FREEFORT 

GOFORT 

Input 

fn 

V 

£81 

FREEFORM FORTRAN 
source statements 

FTnnFOOl 

FORTRAN 

execution 

Input/ Output 

fn 


User input and output files 

GCS 

EXEC 

Input 

fn 

V 

130 

EXEC statements 

GLOBALV 

GLOBALV 

DEFAULTS 

Input/ Output 

fn Initial 

Session 

Lasting 

F/V 

V 

V 

<5201 

£520 

£520 

Collection of named 
variables 

GROUP 

GROUP 

Output 

fn 

F 

80 

Group Control System 
(GCS) data block entries 
used to describe a GCS 
virtual machine group 

HELPABBR 

HELP 

Input 

fn 

V/F 

79 

Input files for HELP facility 

HELPCMS 

HELP 

Input 

fn 

V 

79 

Input files for HELP facility 

HELPCMQ 

HELP 

Input 

fn 

V 

79 

Input files for HEL£ facility 

HELPCMSS 

HELP 

Input 

fn 

V 

79 

Input files for HELP facility 

HELPCP 

HELP 

Input 

fn 

V 

79 

Input files for HELP facility 

HELPCPQU 

HELP 

Input 

fn 

V 

79 

Input files for HELP facility 

HELPCPSE 

HELP 

Input 

fn 

V 

79 

Input files for HELP facility 

HELPDEBU 

HELP 

Input 

fn 

V 

79 

Input files for HELP facility 

HELPEDIT 

HELP 

Input 

fn 

V 

79 

Input files for HELP facility 

HELPEXEC 

HELP 

Input 

fn 

V 

79 

Input files for HELP facility 

HELPEXC2 

HELP 

Input 

fn 

V 

79 

Input files for HELP facility 

HELPGROU 

HELP 

Input 

fn 

V 

79 

Input files for HELP facility 


Figure 4 (Part 2 of 5). Reserved Filetypes 
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Format 



Filetype 

Command 

Usage 

Filename 

RECFM LRECL 

Contents 

HELPHELP 

HELP 

Input 

fn 

V 

79 

Input files for HELP facility 

HELPIPCS 

HELP 

Input 

fn 

V 

79 

Input files for HELP facility 

HELPMENU 

HELP 

Input 

fn 

V 

77 

Input files for HELP facility 

HELPMSG 

HELP 

Input 

fn 

V 

79 

Input files for HELP facility 

HELPPF 

HELP 

Input 

fn 

V 

79 

Input files for HELP facility 

HELPPREF 

HELP 

Input 

fn 

V 

79 

Input files for HELP facility 

HELPQUER 

HELP 

Input 

fn 

V 

79 

Input files for HELP facility 

HELPREXX 

HELP 

input 

fn 

V 

79 

Input files for HELP facility 

HELPSET 

HELP 

Input 

fn 

V 

79 

Input files for HELP facility 

HELPSQLD 

HELP 

Input 

fn 

V 

79 

Input files for HELP facility 

HELPSRPI 

HELP 

Input 

fn 

V 

79 

Input files for HELP facility 

HELPTASK 

HELP 

Input 

fn 

V 

105 

Input files for HELP facility 

HELPTSAF 

HELP 

Input 

fn 

V 

79 

Input files for HELP facility 

HELPXEDI 

HELP 

Input 

fn 

V 

79 

Input files for HELP facility 

SHLPxxxx 

HELPCONV 

Output 

fn 

same as input 

Converted file for HELP 






facility 

LISTING 

ASSEMBLE 


fn 

F 

121 

COBOL processor output 


ASM3705 

pmmi 

fn 



used as input to SOURCE 


ESERV 

GOFORT 


fn 



subcommand of TESTCOB 


FORTGI 

FORTHX 

COBOL 

PLIC 

Output 

fn 





PLICR 

PLIOPT 

Output 

fn 





TESTCOB 

Input 

fn 

V 

121 


LKEDIT 

LKED 

Output 

fn 

F 


Listing 

LOGFILE 

SET 

Output 

fn 

V 

none 

Log of data written to 


LOGFILE 


vscreen 

name 



virtual screen. 

LOAD LIB 

LKED 

Output 

fn 

F 

£260 

3704/3705 control program 


ZAP 

Input 

fn 


load modules 

MAC LIB 

GLOBAL 

Library 

fn 



Macro definitions 


MAC LIB 

Input/Output 

fn 



(dictionary and members) 


MAC LI ST 

Input/Output 

fn 




MACRO 

ESERV 

Input 

fn 

F 

80 

Macro definitions 


MACLIB 

Output 

fn 





Figure 4 (Part 3 of 5). Reserved Filetypes 
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Format 



Filetype 

Command 

Usage 

Filename 

RECFM LRECL 

Contents 

MAP 

DOSLIB 

Output 

libname 

F 

80 

Library map 


DOSLKED 

Output 

fn 



DOS/VS linkage editor map 
Directory information from 


DSERV 

Output 

DSERV 



DOS/VS private or system 


INCLUDE 

Output 

LOAD 



libraries 


LOAD 

Output 

LOAD 



Module map 


MACLIB 

Output 

fn 



Module map 


TXT LIB 

Output 

fn 



Library Map 


TAPE 


fn 



Library Map 

Library Map 

MEMO 




F 

80 


MODULE 

GENMOD 

Output 

fn 

V 


Nonrelocatable object file 


LOAD MOD 

Input 

fn 




MODMAP 

Input 

fn 




NAMES 

NAMEFIND 

Input/Output 

userid 

V 

255 

Information about users in 


NAMES 





communication 

NETLOG 

RECEIVE 

Logging 

userid 

V 

255 

Records logging 


SENDFILE 




transmission of files sent or 
received 


NOTE 

NOTE 

Input/Output 

userid 

V 

132 

Creates a note to be sent to 
others. 

NOTEBOOK 

RECEIVE 

Input 

userid 

V 

132 

Notes sent to or received by 


SENDFILE 




you 

PLI or 

PLIOPT 

Input 

fn 

F 


PL/I source statements 

PLIOPT 

PLIC 

Input 

fn 





PLICR 

Input 

fn 




PROC 

PSERV 

Output 

fn 

F 

80 

A procedure from the 

DOS/VS procedure library 

REPOS 

GENMSG 

Input 

DMKMES 

F 

80 

Source statements for 



DMSMES 



message repositories. 

RTABLE 

PROP 

Input 

fn 

V 

72 

Routing table for 

Programmable Operating 







Facility. 

SCRIPT 

EsnziHi 

Input 

fn 

V 

132 

Input to SCRIPT processor 

SYMDMP 

FCOBOL 

Output 

fn 

V 

512 

DOS/VS COBOL DEBUG 
file for SYMDMP option 

SYNONYM 

SYNONYM 

Reference 

fn 

F 

80 

Command name synonyms 

SYSUT1 

ASM3705 

Work 

fn 



SYSUT2 

ASSEMBLE 

Work 

fn 



SYSUT3 

COBOL 

Work 

fn 





LKED 

Work 

fn 





PLIOPT 

Work 

fn 




SYSUT4 

COBOL 

Work 

fn 

F 

80 

Used as input to TESTCOB 


LKED 

PLIC 

PLICR 

TESTCOB 

Input 



512 


TESTFORT 

TESTFORT 

Output 

fn 

VB 

125 

Processor printed output 


Figure 4 (Part 4 of 5). Reserved Filetypes 
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Format 



Filetype 

Command 

Usage 

Filename 

RECFM LRECL 

Contents 

TEXT 

ASSEMBLE 

Output 

fn 

F 

80 i 

Object code 


ASM3705 

Output 

fn 



3704/3705 source code 
and job control 
language statements 


COBOL 

Output 

fn 



Object code 


DOSLKED 

Input 

fn 



Object code 


GEN 3705 

Output 

fn(Ln) 



Linkage editor control 
statements for 3704/3705 
control programs 



INCLUDE 

Input 

fn 



Object code 


LKED 

Input 

fn 



Object code and LKED 
control cards 


LOAD 

Input 

fn 



Object code 


PLIOPT 

Output 

fn 



Object code 


TXTLIB 

Input 

fn 



Object code 


GOFORT 

Output 

fn 



Object file 


FORTGI 

Output 






FORTHX 

Output 






RSERV 

Output 

fn 





TEXTFORT 

Input 





TXTIangid 

GENMSG 

Output 

fn 

F 

80 

Object code for language 
files. 

TXTUB 

GLOBAL 

Library 

fn 



Object decks (dictionary 


TXTLIB 

Output 

fn 



and members) 

UPDATE 

UPDATE 

Input 

fn 

F 

80 

UPDATE control cards 

U PD LOG 

UPDATE 

Input 

fn 

F 

UPDATE log 

VS BASIC 

VS BAS 1C 

Input 

fn 

F 

£256 

VSBASIC language source 
statements 

VSBDATA 

VSBDATA 

Execution 

fn 

V 

£140 

VSBASIC user input/output 



time files 



files 

UPDTxxxx 

UPDATE 

Input 

fn 

F 

80 

UPDATE control statements 

XEDIT 

XEDIT 

Input 

fn 

V * 

255 

EXEC/XEDIT statements 

ZAP 

ZAP 

Input 

fn 

F 

80 

Control records that modify 


ZAPTEXT 





or dump files 


Figure 4 (Part 5 of 5). Reserved Filetypes 

1 SCRIPT/VS is a component of the IBM Document Composition 
Facility program product, which is available from IBM for a license 
fee. For additional information on SCRIPT/VS usage, see 
Document Composition Facility: User's Guide, SH20-9161. 
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Return Codes 


It a condition arises during execution of a command that results in 
the display of a warning, error, severe error, or terminal error 
message, the command passes a nonzero return code back in 
register 15. 

If no warning, error, severe error, or terminal error messages are 
generated during execution of the command, the return code passed 
back in register 15 is zero. 

Commands that invoke program products pass the return code set by 
that program in register 15. This code may have the same number 
as a CMS code described above; however, it will have been 
redefined by the program product or compiler in operation. 


CMS Return Codes 

The following figure shows the return codes passed by CMS 
commands. 


-0001 

No CP command with this name was found. (The CP error code of + 1 is 
converted by CMS to -0001 for commands entered from the virtual console.) 

-0002 

An attempt was made to execute a CMS command while in CMS subset mode, 
which would have caused the module to be loaded in the user area (LOADMOD 
error code 32). 

-0003 

No CMS command with this name was found. 

-0004 

The LOADMOD failed (for example, there was an error on the module). 

-0005 

A LOADMOD was attempted with the wrong environment (for example, the 
module was generated by the GENMOD command with the OS option and 
LOADMOD was attempted with DOS=ON specified). 

0 

Normal. 

1 

Device disconnected. 

1 

Top or bottom of virtual screen reached. 

3 

Virtual screen, window, or queue already exists. 


Figure 5 (Part 1 of 2). Return Codes Produced by CMS 
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3 

Data, field, or scroll amount is truncated. 

4 

List or queue is empty. 

4 

The user did not specify all the conditions necessary to execute the command as 
intended. Execution of the command continues: however, the result may or may 
not be as the user intended. 

8 

Device errors occurred for which a warning message is issued, or errors have 
been introduced into the output file. 

12 

Errors were found in the input file. 

13 

No space available. 

14 

No reserved or data area. 

20 

Window name of or "=" not allowed. 

20 

An invalid character is in the fileid. Valid characters are: 0-9. A-Z. a-z. $. @. #. 

+ . -(hyphen). :(colon)._ (underscore). 

24 

CMS virtual screen or window cannot be deleted. 

24 

The user did not specify the command line correctly. 

28 

Virtual screen, window, or queue not defined. 

28 

An error occurred while trying to access, or manipulate, a user's files: for 
example, file not found. 

32 

Invalid position specified. 

32 

The user's file is not in the expected format, or the user's file does not contain 
the expected information. 

36 

Window not connected or displaying virtual screen. 

36 

No field to write data/color/exthi/PSset. 

36 

An error for which the user is responsible occurred on one of the user's devices. 

For example, a disk is in read-only status, and needs to be in write status so that 
a file can be written on it. 

40 

A functional error for which the user is responsible occurred during execution of 
the command, or the user failed to supply all the necessary conditions for 
executing the command, or end-of-file. end-of-tape (where applicable). 

41 

Insufficient storage was available to execute the command. 

88 

TTY device. 

88 

A CMS system restriction prevented execution of the command, or the function 
requested is an unsupported feature, or the device requested is an unsupported 
device. 

100 

I/O error. 

100 

Input/output device errors. 

104 

Insufficient storage. 

104 

A functional error for which the system is responsible occurred during execution 
of the command. 

256 

Request rejected by IUCV. 

256 

All unexpected errors for which the system is responsible: that is. terminal error 
messages. 


Figure 5 (Part 2 of 2). Return Codes Produced by CMS 
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CP DIRECT Command Return Codes 

The following figure shows the return codes passed by the CP 
DIRECT command. 


3 

Invalid filename, or file not found. 

2 

Error loading the directory. 

3 

Invalid option from CMS. 

4 

Directory not swapped, user not privilege class A. B. or C. 

5 

Directory not swapped, system (old) directory locked. 

6 

Directory not swapped, the directory in use by the system is not the updated 
directory. 

Ixx 1 

Error in the CMS RDBUF routine. 

2xx x 

Error in the CMS TYPLIN routine. 


Figure 6. Return Codes Produced by the CP DIRECT Command 

1 xx is the CMS routine return code. 
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CMS DDR Command Return Codes 

The following figure shows the return codes passed by the CMS DDR 
command. 


1 

Invalid filename, or file not found. 

2 

Error in executing the program. 

3 

Flagged DASD (Direct Access Storage Device) track. 

4 

Permanent tape or DASD I/O error. 

Ixx 1 

Error in the PRINTIO routine. 


Error in the CON READ routine. 

3xx x 

Error in the RDBUF routine. 

4xx l 

Error in the TYPLIN routine. 


Figure 7. Return Codes Produced by the CMS DDR Command 

1 xx is the CMS routine return code. 


System Product Editor (XEDIT) Command Return Codes 

The following figure shows the return codes passed by the XEDIT 
command. 


-3 

Unknown command; Invalid from environment other than EXEC 2 or REXX 

-2 

Invalid subset command 

-1 

Incorrect operands specified in the PARSE macro 

0 

Normal; Parsing was successful; "n" lines were inserted 


Figure 8 (Part 1 of 3). Return Codes Produced by the XEDIT Command 
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1 

TOF or EOF reached (and displayed) during execution or change; No change 
(SPLTJOIN issued at TOF or EOF); Duplicate name defined; Valid only in 
display mode; Column pointer outside restored zone settings; Only one file 
edited; Parsing incomplete - scanned line does not match PARSE macro 
format; No action taken - cursor will be set outside screen; Out of zone 
definition during execution; Partial delete because EOF or TOF reached 
reached during execution; File has been filed, was only one edited; 

Overlapping groups of lines; Target line within lines to move; No line(s) 
changed or cursor not on valid data field; Total number of lines or columns 
exceeds physical screen size 

2 

Target line not found; Name does not exist for OFF function 

3 

Terminal is not a display terminal; Truncated or spilled; Invalid placement of 
cursor or subcommand; SORT cannot be used when a file is edited in 

UPDATE or extended mode; Operand or subcommand is valid only for 
display terminal; File already exists; RGTLEFT valid in display mode only; No 
PRESERVE has been issued; Pool of deleted lines is empty; "QUERY POINT 

4 ” issued, but no symbolic names defined; Macro not currently in storage; 

LOAD has already been issued; Subcommand is not valid in extended mode 
or records truncated 

4 

Insufficient storage available; No lines changed; Each logical screen must 
contain at least 5 lines and 20 columns; Line is not reserved; Lrecl must be 
lower than 65536 for recfm V; File already in storage; Too many control 
characters defined; Invalid when issued from prefix macro; Macro is in use - 
do not purge; No change occurred (stringl not found); 

5 

Invalid or missing operand, string, or (line) number 

6 

Subcommand rejected in the profile because of LOAD error or QUIT issued 
in macro 

7 

Error building the update file 

8 

Prefix area contains pending subcommand or macro; I/O error or 
modifications lost because PA key pressed when message pending 

12 

Disk defined in filemode is read-only; File has been changed; Use QQUIT to 

QUIT anyway 

13 

Disk is full 

16 

EXEC 2 variable greater than 256 characters 

20 

Invalid character in filename or filetype 

24 

Invalid filemode; Invalid parameters, or options; Invalid columns defined 

28 

Source file not found (UPDATE MODE), or library not found (MEMBER 
option), or specified profile macro does not exist, or file XEDTEMP CMSUTI 
already exists; Filename already exists 

32 

Error during updating process; Record "firstrec” is beyond end of file: File is 
not a library; library has no entries; File is not fixed. 80 character records 

36 

Disk not accessed yet 

40 

No list given 

80 

Unsupported OS data set 

81 

Unsupported OS data set 

82 

Unsupported OS data set 

83 

Unsupported OS data set 

88 

File is too large, cannot fit into storage; or previous MACLIB function not 
found 


Figure 8 (Part 2 of 3). Return Codes Produced by the XEDIT Command 
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100 

Error reading/writing file to disk; Error from rdbuf; Error occurred while 
creating the file 

104 

No storage is available 

nn 

Command's RC specified as operand; Same as repeated subcommand's return 
codes; Return code of CMS or CP command; Return code of subcommand 
or macro or from subcommand following LOCATE 

any 

number 

>10 

Standard CMS HELP command return codes 


Figure 8 (Part 3 of 3). 


Return Codes Produced by the XEDIT Command 
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IPCS Commands Return Codes 


The following figure shows the return codes passed by the IPCS 
commands. 


4 

An incorrectly entered parameter. 

8 

System failure; a read/write error or an invalid internal 
parameter. 


Figure 9. Return Codes Produced by the IPCS Commands 


Example of a Return Code from a CP Command 

Commands or operands of commands passed to CP pass the return 
code sent back by CP to register 15. For example, suppose the user 
is in CMS mode and invokes the CP command LINK: 

ipl cms 

CMS VERSION n.n mm/dd/yy 


cp link to * vaddrl as vaddr2 r 


The user has entered the CP command LINK to userid *. That means 
the user's own directory is searched for device vaddrl. Vaddr2 is 
the virtual address to be assigned to the device for this virtual 
machine. Read-only access is requested. No password is required 
because the user has linked to one of his own disks. 
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The result may be either 

Ready; (or Ready(O);) 

which indicates successful execution. 


or 

Ready(nnnnn); 

which indicates an error. If, as previously described, the contents 
of nnnnn is a CMS return code, then the error occurred in CMS. If 
nnnnn contains a CP message number, the error occurred in CP. 

The return code may be used by a system programmer in the 
DEBUG subcommand and also in EXEC procedures. See the VM/SP 
CMS Command Reference or EXEC 2 Reference for a description of 
the *RC’ special variable. 
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Chapter 3. Summary of VM/SP Commands and Service Aids 


The remainder of this book details command formats and 
descriptions. Also included are macro formats and service aids. 

It is recommended that VM/SP users of RSCS obtain the RSCS 
Networking Version 2 (5664-188) fji'ogram product. This program 
product takes advantage of the enhanced functions of VM/SP. The 
commands listed are for the RSCS program product. 

Users of VM/SP who intend to use the RSCS component of VM/370 
Release 6 should retain the Release 6 reference library. 

VM/SP has an enhanced Interactive Problem Control System (VM/SP 
IPCS) component. This component replaces the unmodified VM/370 
interactive problem control system. Details of this major component 
are found in the VM Distributed Data Processing Guide, LY24-5241. 

Note: The VM/SP Release 4 base product is enhanced to include 
function equivalent to that within the VM/Interactive Problem Control 
System Extension (VM/IPCS/E) licensed program product (5748-SA1). 
The IPCS commands listed here are those of VM/SP IPCS. 
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Notational Conventions 


The following symbols should be coded as they appear in the 
command format: 

asterisk * 

comma t 

hyphen 
equal sign 
parentheses () 

period 

colon : 


The following symbols are used to define the command format and 
should not be coded as part of the command. 

braces { } 

indicate choices, one of which must be selected. If a list of 
choices is enclosed by neither brackets or braces it is to be 
treated as if enclosed by braces. 

brackets [ ] 

indicate optional choices, one of which may be selected, 
underscore _ 

indicates a default option. If the underscored option is selected, it 
need not be specified. 

vertical bar | 

separates the operand alternatives within the brackets and 
braces. 

ellipsis .... 

indicates that the preceding item may be repeated more than 
once. 
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The commands and subcommands are shown in uppercase and 
lowercase. The uppercase represents the minimum truncation of the 
command or keyword operand that the system accepts. An 
all-lowercase operand indicates a user- or system-supplied variable 
value. Variable abbreviations used are shown in the following 
figure. 


Short Form 

Meaning 


Alphameric information 

addr 

Storage address 

cc 

Cylinder number 

col 

Column 

cuu 

Virtual device address 

cyl 

Cylinder 

dasd 

Direct access storage device 

fileid 

fn ft [fm] 

fm 

filemode 

fn 

filename 

ft 

filetype 

hexloc 

hexadecimal storage location 

mode 

Mode letter or mode letter and mode number 

nn 

Decimal information 

psw 

Program status word 

raddr 

Real storage address 

rec 

record 

vaddr 

Virtual storage address 


Figure 10. Syntax Abbreviations Used 

For a detailed and thorough explanation of command formats and 
notational conventions, see the VM/SP CMS Command Reference. 
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CP Privilege Classes 


The CP commands are divided into seven functional types: 
operations, resource, programmer, spooling, analyst, CE, and 
general. These types apply whether the installation retains the 
IBM-defined class structure or establishes its own class structure. 
Each functional type corresponds to one IBM-defined privilege class. 
For details of the function of each IBM-defined privilege class and its 
corresponding function type, see the VM/SP CP Command 
Reference. Each user is assigned, as part of his entry in the 
directory, one or more privilege classes. 

This is a summary of the CP privilege classes and the functions 
performed by each class of user: 

Class A Primary System Operator 

The class A user controls the VM/SP system. Class A is 
assigned to the user at the VM/SP system console during 
IPL. The primary system operator is responsible for the 
availability of the VM/SP system and its communication 
lines and resources. In addition the class A user controls 
system accounting, broadcast messages, virtual machine 
performance options, and other command operands that 
affect the overall performance of VM/SP. The system 
operator controls operation of the real machine using the 
system control panel and console device. 

Note: The class A system operator who is automatically 
logged on during CP initialization is designated as the 
primary system operator. 

Class B System Resource Operator 

The class B user controls allocation and deallocation of all 
the real resources of the VM/SP system, except those 
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controlled by the primary system operator and spooling 
operator. 

Class C System Programmer 

The class C user updates certain functions of the VM/SP 
system. The system programmer can modify real storage 
in the real machine. 

Class D Spooling Operator 

The class D user controls spool data files and specific 
functions of the system's unit record equipment. 

Class E System Analyst 

The class E user displays the contents of real storage, 
performs the functions required to generate saved systems 
and discontiguous saved segments, and controls the 
collection and recording of performance measurement 
data. This class of user can display the contents of 
specified real storage areas on the virtual operator's 
console or on a spooled virtual printer, but cannot modify 
real storage. 

Class F Service Representative 

The class F user obtains and examines, in detail, certain 
data about input and output devices connected to the 
VM/SP system. The service representative can establish 
intensive recording mode for one I/O device at a time and 
can cause the recording of repressible machine check 
errors to be initiated or resumed. 

Class G General User 

The class G user controls functions associated with the 
execution of his virtual machine. A general user cannot 
display or modify real storage. 
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Class Any The Any classification is given to certain CP commands 
that are available to any user. These are primarily for the 
purpose of gaining and relinquishing access to the VM/SP 
system. 

Class H Reserved for IBM use. 
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Chapter 4. CP, CMS, GCS, TSAF, RSCS, and IPCS Commands 


The remainder of the book contains CP, CMS, GCS, TSAF, IPCS, and 
RSCS commands and the VM/SP service aids. A brief description 
precedes a syntactic representation of each command. 

Note: RSCS commands must be preceded by "RSCS”, if issued by 
the console operator, or by “SMSG RSCSvmid” if issued by a 
system-authorized alternative operator. 

Note: Either the TSAF virtual console or the secondary user of the 
TSAF virtual machine issues the TSAF commands. If the secondary 
user issues the commands, TSAF commands must be preceded by 
SEND userid. The value in userid is the userid of the 
disconnected TSAF virtual machine. 


* CMS, CP CLASS ANY, GCS, RSCS 

Permits comments 

* anycomment 


#CP CP Class Any 

Executes a CP command while in a virtual machine command environment without first signaling 
attention to get to the CP command environment. 

#CP [commandlinel [#commandline2 #...]] 
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ACCESS 


ACCESS 


CMS 


Defines direct access space to a CMS virtual machine and relates it to a logical directory. 



options: 


[/ext 



[NOPROF] 


'erase 

SAVEONLY 

NOSAVE 


[NODISK] 


[ (options...[)]] 


ACCESS GCS 

Identifies CMS or VSAM disks that an application will use. 

Unlike the CMS ACCESS command, you cannot specify options, and you cannot have an 800 byte 
blocksize. 





. 


1 1 

ACCESS 

cuu 

mode [/ext 

f n 

[ ft 

Hi 


191 

A 

* 

- 

U J 




* 

V 

* J , 


ACNT 


Creates accounting records. 

ACNT fuseridl [userid2...] 
J ALL [CLOSE] 

I CLOSE 


} 


CP Class A 
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ADD LINK 


ADD LINK TSAF 

| Identifies a communication link to TSAF when the TSAF virtual machine is running. Only the TSAF 
I virtual console or the secondary user of the TSAF virtual machine can issue this command. 

| ADD LINK vdev 


ADSTOP 


Halts the virtual machine's execution. 


ADSTOP Jhexlocl 
| OFF J 


CP Class G 


| ALARM VSCREEN CMS 

| Sounds the terminal alarm the next time the display is refreshed. 

| ALARM VSCreen vname 


AMSERV CMS 

Defines VSAM catalogs, data spaces, or clusters. Alters, lists, copies, deletes, exports, or imports 
VSAM catalogs and data sets. 

AMserv fnl [fn2 I fnl ] [ (options ...Mil 
options: 

[PRINT] [TAPIN {18n|TAPn}] [TAPOUT £18n|TAPn}] 
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APAR 


APAR IPCS 

Invokes the functions of the PRB and PROB commands and produces a hard-copy APAR form for 
submittal to IBM. 

APAR 


ASMGEND CMS 

Builds the system assembler and creates the associated auxiliary directory. (System programmers 
only) 

ASMGEND 


ASM3705 CMS 

Invokes the 3705 assembler. 

Note: All of the options of the 3705 XF Assembler are supported and may be used with the 
ASM3705 command, with the exception of ALIGN|NOALIGN and TEST| NOTEST. 

ASM3705 fn [(options...!)]] 


options: 


[ LIST I NOLIST] 

[ LINECOUN 55|LINECOUN nn] 

[ DISK I PRINT 1 NOPRINT1 
[ XREF (SHORT) |XREF (FULL) |NOXREF] 
[DECKI NODECK 1 
[RENT I NORENT ] 

[LOAD|NOLOAD] 
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ASSEMBLE 


ASSEMBLE CMS 

Invokes the system assembler. 

Assemble fn [(options...[)]] 
listing control options: 

[ ALOGIC |NOALOGIC J [MLOGIC| NOMLOGIC ] 

[ESP INOESD] [ RLD|NORLD ] 

[ LIST |NOLIST] fLIBMACI NOLIBMAC 3 

[MCALLI NOMCALL ] [ FLAG (0) 1 FLAG (nnn)] 

[ LINECOUN (55) ILINECOUN (nn)] 

[ DISK I PRINT|NOPRINT] 

[XREF (FULL)I XREF (SHORT) INOXREF] 

output control options: 

[DECK I NODECK ] [ OBJECT iNOOBJECT] 

[TEST I NOTEST ] 

SYSTERM options: 

[ NUMBER |NONUM] [ STMT |NOSTMT] 

[ TERMINAL |NOTERM] 

other options: 

[ ALIGN INOALIGN] [ BUFSIZE (STD) IBUFSIZE (MIN)|BUFSIZE (MAX)] 

[RENT I NORENT ] [SYSPARM (string) |SYSPARM (?)|SYSPARM ()] 

[WORKSIZE ( 2Q48K) | WORKSIZE (nnnnnK)] 

[YFLAGI NOYFLAG 1 
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ASSGN 


ASSGN 


Assigns or unassigns a system or programmer logical unit for a virtual I/O device. 


ASSGN SYSxxx 


Reader 

Punch 

PRinter 

Terminal 

TAP [n|l] 

mode 

IGN 

UA 


[ (options...[)]] 


CMS 


options: 

[ UPCASE ILOWCASE] [7TRACK|9TRACK] (TRTCH a] [DEN den] 


ATTACH 

Attaches a real device to a specified user or to the system. 


CP Class B 


ATTach 


f raddr [TO] (userid [AS] vaddr [R[/0]]1 
^SYSTEM [AS] volid J 


[3330V] [VOLID volid] 


4 


(raddr... 

\raddr-raddrf [TO] userid [R[/0]] [3330V] 


Laddr 


[TO] userid 


[AS] vaddr 


CHANnel c [PROC nn] [TO] ^userid^ 


ATTN CP Class G 

Makes attention interruption pending. 

ATTN 
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AUTOLOG 


AUTOLOG CP Class A or B 

Logs on any virtual machine that is defined in the VM/370 directory. 

AUTOLOg userid password [variable data] 


B CMS Border Command 

Scrolls the window backward. 

B 


BACKSPAC CP Class D 

Restarts or repositions a current spool file. 


Printer Format: 


Punch Format: 



File 

pages 

1 


[EOF] 


BAckspac raddr [ File ] 


BACKSPAC RSCS 

Restarts or repositions in a backward direction the file currently being transmitted. This command 
is for RJE, 3270P, SNA3270P, and MRJE type links. 

BAckspac [linkid] [ File Innn] 


BEGIN CP Class G 

Starts the execution of a virtual machine. 

Begin [hexloc] 
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C (CMS Border Command) 


C CMS Border Command 

Clears the window of scrollable data. 

c 


CATCH ECK CMS 

Invokes the VSE/VSAM Catalog Check Service Aid to verify a complete catalog structure. Provides 
a print file containing the catalog analysis. 

CATCHECK f catname 1 

^catname/password I 
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CHANGE 


CHANGE 


CP Class D 


Alters the attributes of a closed spool file. 


CHange userid 
SYSTEM 


CLass cl 
FORM forml 
DEST destl 
spoolid 
ALL 


CHars nameO 


[CHars] 

[CHars] 

[CHars] 


CLass c2 
COpy[*]nnn 
DIst distcode 
2 

FCB name 
FLash name nnn 
FORM form2 
DEST dest2 


HOLD 

NOHOLD 


Modify name[n] 


3 ff n [ ft ]1 
Idsnamel 


1 One of these options must be chosen; however, more than one may be specified and they may be 
in any sequence. 


The CHars, FCB, and MOdify options are valid for only the 3800 printer. 
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CHANGE 


CHANGE 


CP Class G 


Alters the attributes of a closed spool file. 


CHange 


Reader j 
" Printer! 1 
# Punch J* 


CLass cl 
spoolid 
FORM formll 
DEST destli 
ALL 


fcLass c2 



DIst dist 
COpy [*]nnn 
^FLash name nnn^ 


1 


[ NAme ffn [ ft: 1 
Idsname |I 


jMOdify name 
I CHars namel 


FCB name 
FORM form2 
DEST dest2 
k UNCONV 


[n] 

[CHars]name2 
[CHars]name3 
t [CHars ] name4 4 


1 One of these options must be chosen; however, more than one may be specified. They may be 
combined in any sequence on the command line, except for NAME which, if specified, must be 
the last entry in the command line. This is contrary to the notation normally used in this 
publication. 


62 VM/SP Quick Reference 




CHANGE 


CHANGE RSCS 

Alters one or more attributes of an inactive spool file. 

General User Format: 

CHange [*]spoolid options...* 

Operator Format: 

CHange [linkid] spoolid options...* 

* You must include at least one of the following options: 


[PRIority 

nn ] 

[CLass 

c ] 

[COpy 

[*]nnn ] 

[DIst 

distcode ] 

[FLash 

name nnn ] 

[HOld 

|NOHold ] 

[Modify 

name [trc] ] 

[CHars 

namel [CHars name2 

[ FCB 

name ] 

[FOrm 

cccccccc ] 

[DEST 

{cccccccc|OFF}] 


Name {fn [ft]|dsname} 


I CLEAR VSCREEN CMS 

i Erases data in the virtual screen by overwriting the data buffer with nulls. 

| CLEAR VSCreen vname 


| CLEAR WINDOW CMS 

| Scrolls past all data in the virtual screen to which the window is connected so no scrollable data is 
| displayed in the window. 

| CLEAR WINdow fwnamel 

i l - J 
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CLOSE 








CMSGEND 



COMPARE CMS 

Compares two existing files on a record for record basis and displays dissimilar records. 

COMpare fileidl fileid2 [(option[)]] 
option: 

COL 

[ mmm[-]nnnl 
1 lrecl I 
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CONVERT 


CONVERT IPCS 

Converts symptom summary file and PRBnnnn dumps from the system component IPCS format to 
that required for VM/IPCS/E. 

CONVERT fn [ft [fm]] 


, CONVERT COMMANDS CMS 

| Use CONVERT COMMANDS to take DLCS statements in a CMS file and create an internal form (a 
j text deck) of the table for the parsing facility to use. 

| CONVert COMmands fn [ft [fmj] [(options ... [)]] 

I [DLCS [* ]] 

| options: [( [ SYStem I USER I ALL] 

| [ CHeck I OUTmode Jjilfm]] 

| STACK [FIFO|LIFOj* 

j FIFO 

| LIFO 


CONVIPCS EXEC IPCS 

Converts PVM Release 2 or RSCS Release 3 help files to format required for VM/SP IPCS usage. 

CONVIPCS 


CONWAIT CMS 

Causes the program to wait until all pending terminal I/O is complete. 

CONWAIT 
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COPYFILE 


COPYFILE 

Copies files according to operand specifications. 

COPYfile fileidil [fileidi2...] [fileido] [(options...[))] 
options: 

[ Type 1 TNEWDatel pJEWFile l fPRompt 1 

NOType j [oLDDateJ [REPlaceJ [NOPRomptJ 

[ FRom recno 1 fFOR numrec 1 TSPecs 1 fOVly 1 

FRLabel xxxxxxxxj ^TOLabel xxxxxxxxl I NOSPecs I [APpendl 

Fill c *1 
Fill hh 
Fill 40 I 


[EBcdic] fUPcase 1 [TRAns] [Single] 
[^LOwcaseJ 


RECfm §] 


[LRecl nnnnn] 


[ TRUnc 1 fl 
NOTRuncJ [l 


PAck 1 
UNPackJ 


CMS 


COUPLE CP Class G 

Connects virtual channel to channel adapters. 

COUPLE vaddrl [TO] userid vaddr2 


CP CMS 

Permits entry of CP commands without leaving the CMS environment. 

CP tcommandline] 


CP CP Class Any 

Permits execution of CP commands within your privilege class. 

CP [commandlinel [#commandline2 #...]] 
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CP 


CP RSCS 

Executes a command line as a VM/370 Control Program (CP) console function without leaving the 
RSCS command environment. (For RSCS operator only) 

CP command text 


CPQUERY 


Requests status information from CP, similar to a VM/370 CP QUERY command. 


CPQuery 


INDicate 

LOGmsg 

Names 

Time 

Users [userid] 

CPUid 

CPLEVEL 


RSCS 
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CPTRAP 


CPTRAP 




CP Class C 

Use to create a file of trace table and CP and virtual machine interface records in the order they 
happen for problem determination. The CPTRAP READER file can be printed out or displayed at a 
terminal using the TRAPRED command. 

CPTrap 

typenum 

Vmblok address 

DEVaddr cuu 

COde code-value 

|<OFT 




ALL 

f- 1 

[offJ 




ALLOWid 
GRoupid 

userid 

group-name 


* 


STArt 

[TO] ^userid^l [WRAP wrap-size] 



CLOSE 

b * 




STOP 




CURSOR VSCREEN 


CMS 

Positions the cursor on a specified line and column in a virtual screen. 

CURsor VSCreen vname line col [(options[)]] 



options: r Reserved! 

i Data J 




D CMS Border Command 

Drops the window. 

D 
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DCP 


DCP 

Displays real processor storage on the terminal. 

DCP 


f-\piexloc2l 

Vfl Me J 


MLhexlocl 
NLhexlocl 
MThexlocl 
NThexlocl 
Mhexlocl 

Nhexlocl {.}fbytecount] 
Lhexlocl 
Thexlocl 
hexlocl 
L 
T 
0 


L M2 J 


CP Classes C and E 


DDR 


Dumps, restores, prints, or copies data from DASD devices and tape devices. 

DDR [fn ft [fm|M ] 


I/O definition statements: 


flNput \ 

cuu type rvolserl [(options.. 

. [) 

lOUTputJ 

[altapej 



options: 


'REWind 


MOde 

800* 

T SKip nnl 

LEave 


MOde 

1600 

[sKip 0 J 

UNload 


MOde 

6250 



MOde 

38K 



[ COmpact l 


CMS 
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DDR 


DDR (continued) 

SYSPRINT control statement: 
SYsprint {cuu|CONS} 
function control statements: 



1 


[ FTr ] 


cyll [To] [cyl2 [Reorder] [To] [cyl3]] 

blockl[To][block2[Reorder[]To][block3]] 

CPvol 

Nucleus 

ALL 


PRINT/TYPE function statements: 

{ PRint \ fcyll [hhl [rrl]][To cyl2 [hh2[rr2]]][(options...[)] 
TYpe J ^blockl[To block2] 

options: 


[Hex] [Graphic] [Count] 

1 The FTr option is valid only with the DUMP control statement. 


CMS 
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DEBUG 


DEBUG 

Enters the DEBUG environment to test and debug a program. 

DEBUG 

The format of each DEBUG subcommand is followed by its description: 

BReakfid symbol! 

I hexlocj 

Stops program execution at a specific instruction location. 

CAW 

Displays the Channel Address Word (CAW). 

CSW 

Displays the Channel Status Word (CSW). 


DEFine symbol hexloc fbytecountl 

U J 

Assigns a symbolic name to a specific storage address. 


symboll 

’symbol2 


hexlocl 

hexloc2 [ident] 


0 

* 



32 






Dumps the contents of storage locations to the virtual printer. 

GO [symbol] 

[hexlocj 

Exits from the DEBUG environment and begins program execution. 


CMS 
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DEBUG 


DEBUG (continued) CMS 

GPR regl [reg2] 

Displays the contents of the specified general registers. 

HX 

Returns to CMS environment. 

ORigin { symbol|hexloc|0 } 

Sets a base address. 


PSW 

Displays old PSW. 

RETurn 

Returns to CMS environment when DEBUG environment was entered via DEBUG command. 


SET 


'CAW hexinfo n 

CSW hexinfo [hexinfo] I 

PSW hexinfo [hexinfo] f 

>GPR reg hexinfo [hexinfo]J 
Changes the contents of the specified general registers and control words. 


STore /symbol! [hexinfo [hexinfo]] 
ihexlocj 

Stores up to 12 bytes of hexadecimal information in the specified virtual location. 


X /symbol [n I LENGTH U 
jhexloc [n|4] J 

Examines virtual storage locations. 


DEFAULTS CMS 

Set or display default options for the commands: FILELIST, HELP, NOTE, RDRLIST, RECEIVE, PEEK, 
SENDFILE, TELL, and MACLIST. 

DEFAULTS /Set command options...1 
/ LIST [command] J 
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DEFINE 


DEFINE CP CLASS A or B 

Redefines the status of a 3330V volume. 

DEFine fSysvirt \ raddrl [-raddr2] 

^ Virtual J 
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DEFINE 


DEFINE 


Reconfigures the user's virtual machine or channel operating mode. 


DEFine 


Reader [AS] VADDR 
Printer 1403, 1443 . . . 4248 


Printer [As] vaddr 
PRT 


1403 

1443 

3203 

3211 

3262 

3289E 

3800 

3800-1 

3800-3 

4245 

4248 


Printer 
PUnch 
CONsole 
CTCa 
TIMer 
1403 
1443 
2501 
2540P 
- 2540R 

3088 
3203 
3211 
3262 
3289E 
3505 
3525 
4245 
„ 4248 


[As]vaddr 


CP Class G 
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DEFINE 


DEFINE (continued) 


[*3800 ' 

J3800-1 . 
[3800-3 


[As] vaddr [Size ww 11] 


CHANnels [As]fSEL) 

\BMXJ 

Line [As] vaddr |*TELE[2]1 

vaddr1 [As] vaddr2 


[ TELE [ 2 ]1 

imu \ 


[ 2WCGM1 rBTSi fDAtck 
4WCGM J [ cFS J [NODatck 


GRAF cuu 


3033 

3036 

3138 

3148 

3158 

3270 


TFB-5121 

T3310 V [As] vaddr [BLK] [nnnnnn] 
,T3370 J 


T2305' 
T2314 
T2319 
T3330 
T3340 
T3350 
T3375 
T3 380, 


[As] vaddr [CYL] [nnn] 


CP CLASS G 


STORage [As] fnnnnnKl 
JnnM J 


76 VM/SP Quick Reference 



DEFINE 


DEFINE RSCS 

Temporarily adds a new link definition to the RSCS link table, or temporarily alters an existing link 
definition. (For RSCS operator only) 


DEFine linkid [ASTartjNOASTart] 

[CLass c ] 

[DP dpriority ] 

[KEEP holdslot ] 

[LINE vaddr ] 

[LOGMode logmodename ] 

[LUName luname ] 

[Queue ( Priority !FifojSize) ] 


TYPE 


"NJE 'I 

SNANJE 
RJE 
MRJE 
3270P 
.SNA3270P 

[Parm [parameters...] ] 


DEFINE VSCREEN 


CMS 


| Creates a virtual screen. 

| DEFine VSCreen vname lines cols rtop rbot [(optionA optionB optionC optionD[)]] 

! optionA: p TYPe 1 

| [NOTypeJ 

| optionB: fPRotect 1fHigh 1 

| [NOPRotect ] [NOHigh j 


optionC: [color] [exthi] [PSset] 

optionD: fUSer 1 

[sYstemJ 
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DEFINE WINDOW 


DEFINE WINDOW 

Creates a window. 


DEFine WINdow wname lines cols psline pscol [(options...[)]] 



CMS 


DELETE RSCS 

Temporarily deletes a link definition from the RSCS link table. (For RSCS operator only) 

DELete linkid 


| DELETE LINK TSAF 

| Removes a communication link from TSAF's list when the TSAF virtual machine is running. Only 
| the TSAF virtual console or the secondary user of the TSAF virtual machine can issue this 
I command. 

| DELETE LINK vdev 


DELETE VSCREEN CMS 

| Removes a virtual screen definition. 

| DELete VSCreen vname 
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DELETE WINDOW 


I DELETE WINDOW CMS 

| Removes a window definition. 

| DELete WINdow wname 


DESBUF CMS 

Clears the console and program stack input and output buffers. 

DESBUF 


DETACH 

Removes a real device from the system or from a specific user. 


i 

i 


DETach 


fraddr i 

[FROM] 

fuserid^ 

f UNloadl 

|raddr... j 


\SYSTEMf 

[LEave J 

[raddr-raddrj 


l * J 


Laddr 

[FROM] 

userid 



CP Class B 


CHANnel c [PROC nn] 


[From] 



| UNLoad and LEave can be used with tape devices only. 


DETACH CP Class G 

Removes a virtual device from the virtual machine. 


DETach f[vaddr [vaddr...]]1 
[ [vaddr-vaddr ]J 
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DIAL 


DIAL 

Attaches a terminal device to a multiple access system. 

DIAL userid [vaddr] 


DIRECT 

Allows creation, editing, and swapping of VM/SP user directory. 


DIRECT 


f ft Ml 

[ DIRECT [* Jl 


fn ft 
USER DIRECT 


[(EDIT)] 


Control statements: 

Account number [distribution] 

CLASS classes 

Console vaddr devtype [class] [userid] 


Dedicate 

NETwork vaddr resource 

vaddr rdev I 

f[VOLID] 

[volser] 

[3330V] 

[R/o]H 

DIRectory < 
Ipl iplsys 

1 

zuu devtype volser [alt 
[PARM data] 

[[VOLID] 

- cuu ] 

[volser] 

[3330V] 

[R/01JJ 


IUCV 


userid 
*CCS 
*SIGNAL 
ALLOW 
ANY 


[PRIORITY] [MSGLIMIT limit] 


Link userid vaddrl [vaddr2 [mode]] 


CP Class Any 


CMS 
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DIRECT 


DIRECT (continued) 


CMS 


Mdisk cuu devtype rcylr cyls volser [mode[pr[pw[pm^]] 
Jt-DISK cyls 
Iblkr blks 

Option [Realtimer] [Ecmode] [Virt=Real] [Acct] [Svcoff] [BMX] 
[CPUID bbbbbb] [AFFinity nn] [Isam] 

[VMsave] [STFirst] [370E] [Maxconn nnnnn] [MIH] 

[DIAG98] 

[VCUNOSHR] 


SCReen area 


{ color fhilightl 1 fhili 

[ NONe J J 1 


hilight 



SPEcial vaddr devtype [IBM Tele] 
Spool cuu devtype [class [ww[ll 


2WCGM 

4WCGM 


[ CFS pATCK 11 
BTS [nODATCk JI 


1 

User userid pass [stor [mstor [cl * [pri le 

Id 

cd 

es 


ON 

OFF 

ON 

OFF 

on Ton 1 

OFF [oFfJ 


1 If you use *, the USER control statement should be followed immediately by the CLASS control 
statement. 


DISABLE 


Prevents communication lines from accessing VM/SP. 


DISAble 


raddr... 
Laddr... 

SNA [userid] 
ALL 


CP Class A or B 


DISCONN CP Class Any 

Disconnects the terminal from VM/SP system while virtual machine continues operation. 

DISConn [HOld] 
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DISCONN 


DISCONN RSCS 

Places RSCS in disconnect mode and optionally directs RSCS operator console output to another 
virtual machine. (For RSCS operator only) 

DISConn [{LOG INOLog} [userid]] 


DISK 


Dumps disk files to punched cards and restores disk files. 

DISK f DUMP fn ft [fm] 1 
l LOAD ((options()]] J 


Options: 

Fullpromptl j Replace 1 [OLDDate] 

Minprompt I INOReplace I 

NOPrompt I * 


CMS 


| DISKMAP CMS 

| Summarizes the MDISK statements in a CP directory. The output of the exec shows gaps and 
j overlaps between minidisk assignments. 

| DISKMAP filename f filetype 1 

I I direct I 
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DISPLAY 


DISPLAY 


CP Class G 


Displays storage locations (second-level only), registers, program status word, channel address 
word, and channel status word. 


Display 


“ hexlocl' 
Khexlocl 

Lhexlocl 

.Thexlocl. 


’hexloc2l 

END J 

‘bytecountl 

.M2 J 

Gregl 

Yregl 

Xregl 

{:} [Si 


t- 

} rregcountl 

[end J 

Psw 

CAW 

CSW 
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DLBL 


DLBL CMS 

In CMS/DOS, defines DOS and CMS sequential disk files for program input/output; identifies DOS 
files and libraries; defines and identifies VSAM catalogs, clusters, and data spaces; identifies 
VSAM, DOS, or CMS files uses for VSAM program input/output and access method service 
functions. 

In CMS, defines and identifies VSAM catalogs, clusters, and data spaces; identifies VSAM files used 
for program input/output; identifies VSAM files used for program input/output; identifies 
input/output files for Access Method Services. 


DLBL 


ddname (mode \ [CMS fn ft 1 [(optionA optionB[K 


DUMMY 


H CMS 
CMS 


FILE ddnameI 


ddname fmode 1 

'dsn quail 

[.qual2. 

..qualn] 

IDUMMYJ 

DSN quail 

[qual2.. 

.qualn] 


DSN ? 


. 


^ddname^ CLEAR 


[(optionA optionB optionC [)]] 


optionA: 

optionB: 

optionC: 

[SYSxxx] 

[PERM] 

[VSAM ] 


[ CHANGE 1 

[extent! 


[nochange] 

[mult J 


[CAT catdd] 
[BUFSP nnnnnn] 
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DLBL 


DLBL 

Defines VSAM files used for program input/output. 


DLBL 


ddname mode 


[ DSN q 
DSN ? 


quail [ [ . ] qual2 . . . qualnjl [(option E 


ddname CLEAR 
* 


optionB: 


optionC: 


[PERM] [VSAM ] 

[MULT ] 

[CAT catdd ] 

[ CHANGE 1 [BUFSP nnnnnn ] 

NOCHANGEJ 


DMCP 

Dumps any area of System/370 real storage to a spool device. 








DMCP 


MLhexlocl 

NLhexlocl 

MThexlocl 

NThexlocl 


f : 1 rhexloc2l 

l-J l MO J 




Mhexlocl 


{.} Tbytecountl 




Nhexlocl 

Lhexlocl 

Thexlocl 


l M2 J 




hexlocl 






0 


■ 

j 


[* dumpid] 


GCS 


option C [)]] 


CP Class C or E 
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DOSLIB 


DOSLIB CMS 

Deletes, compacts, or lists information about the executable phases in a CMS/DOS phase library. 


DOSLIB 


I 


DEL libname phasenamel 

COMP libname 

MAP libname [(options. 


[. 
. [ 


.phasenamen] 
1 1 


options: 


'term ' 

DISK 

PRINT 


DOSLKED CMS 

In CMS/DOS, link-edits TEXT files from CMS disks, or object modules from DOS/VSE private or 
system relocatable libraries, and places them in executable form in a CMS phase library (DOSLIB). 


DOSLKED fn flibname! [(options...[)]] 

Lin J 


options: 
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DRAIN 


DRAIN CP Class D 

Stops spooling activity on the specific device after the current file is finished spooling. 


DRain 


Reader 

Printer 

PUnch 

raddr... 

lprt 

ALL 


DRAIN RSCS 

Deactivates an active communication link after the current file has finished being transmitted. 

DRain [linkid] 


| DROP WINDOW 

| Moves a window down in the order of displayed windows. 

I DROP WINdow 


( wnamel fnl 

« I UJ 


CMS 


DROPBUF CMS 

Eliminates only the most recently created program stack buffer or a specified program stack buffer 
and all buffers created after it. 

DROPBUF n 
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DSERV 


DSERV 


Obtains information contained in DOS/VSE private or system libraries. 


DSERV 



[d2 ... dn][(options...[)]] 
options: 

‘ disk 1 

TERM 1 
PRINT] 


[SORT ] 


DUMP CP 

Dumps virtual machine registers, program status word, and storage to the virtual printer. 


DUmp 

Lhexlocl 


J'l 1 

' hexloc2l 



Thexlocl 


VJ 1 

[end J 

[*dumpid] 


hexlocl 

- 

{.} 

‘bytecountl 

- 





END J 



CMS 


Class G 
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DUMPSCAN 


DUMPSCAN GCS 

This is an IPCS command that enables you to interactively examine a dump of a Group Control 
System (GCS) virtual machine existing as a CMS file. 

The DUMPSCAN subcommands, supported by GCS, followed by their descriptions, are: 

IUcv 

Displays all entries in the IUCV path table. 

TActive ftaskidl 

[ ALL J 

Displays the task's active program list. 

TLoadl [ taskidl 

[ ALL J 

Displays the task load list. 

TSab ftaskidl 

[ ALL J 

Displays the subpool map and chain header of a task. 

VMLoadl 

Displays information about all NUCCBLKs on a virtual machine's load list. 
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DUMPSCAN 


DUMPSCAN 


IPCS 


Enables you to Interactively examine a dump existing as a CMS file created by IPCSDUMP. 

DUMPSCAN 


HELP 

nnnnn 


[11 


The DUMPSCAN subcommands, followed by their descriptions, are: 
(null line) 

Reissues the previous CHAIN, LOCATE, or SCROLL subcommand. 


(Common) 


? (Common) 

Displays last subcommand entered. 

+ (increment) (Common) 

- (decrement) 

Adjusts the address pointer and reissues the DISPLAY command. 

&name [subcommand] (Common) 


& 

Creates a synonym for frequently used subcommands. 

Aregs (CP dump only) 

Displays the registers, clocks, PSW, CSW, and CAW for the attached or the non-IPL processor 
(AP). 


ARIOBLOK cuu (CP dump only) 

Displays the RCHBLOK, RCUBLOK, and RDEVBLOK for the specified device attached to the 
non-IPL processor in an MP configuration. 

C (CP dump only) 

Displays the control registers for the failing processor. 
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DUMPSCAN 


DUMPSCAN (continued) IPCS 

CHain fromhexloc increment endval (Common) 

Verifies the chain of homogeneous control blocks that start at the specified location. 

CMS (Common) 

Enters the CMS subset environment. 

CMSPoint (CMS dump only) 

Displays the formatted contents of 17 pointers from CMS NUCON. 

CORtable hexloc (CP dump only) 

Displays page status and the formatted contents of the CORTABLE entry for the hexadecimal 
location specified. 


Displayf 


hexloc 


[nnnn] 


(Common) 


i hexloc% > 

Thexloc I 
lThexloc%J 

Displays areas in the dump. The actual address or an indirect address may be specified. 


DOSPoint (CMS dump only) 

Displays the formatted contents of five pointers used by DOS simulation. 


DUMPID (Common) 

Displays a dump identification message and the dumpid information from the VMDUMP 
command line (if any). 


END 

Ends the session and returns to CMS. 


(Common) 


Chapter 4. CP, CMS, GCS, TSAF, RSCS, and IPCS Commands 


91 




DUMPSCAN 


DUMPSCAN (continued) 

FDISPlay 

only) 


PATH 

SERVice 

CLUSter 

RESOurce 

NEIGhbor 

ROUTing 

LINKDef 

LINKCtl 

.ALL 



IPCS 


(TSAF dump 


Displays data control blocks, tables and arrays important to the TSAF virtual machine. 

G (Common) 

Displays the set of general registers in the failing processor or virtual machine. 

HELP (Common) 

Displays a summary of the DUMPSCAN subcommands. 

HX (Common) 

Ends the session and returns to CMS. 


IPCSMAP (Common) 

Adds an IPCS map to the dump being viewed. 


Locate 

( string 1 

fromhexloc tohexloc [increment' 

(Common) 

Locate Up 

1 X'string/ 

1 



Searches the dump for a particular string of data. 
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DUMPSCAN 


DUMPSCAN (continued) IPCS 

MAPA hexloc (Common) 

Locates the module that contains the address specified. 

MAPN mmmmmmmm (Common) 

Searches the load map for an entry point. 

Mregs (CP dump only) 

Displays the registers, clocks, PSW, CSW, CAW and timers for the main or the IPL processor. 

MRIoblok raddr (CP dump only) 

Displays the RCHBLOK, RCUBLOK, and RDEVBLOK for the specified device attached to the 
IPL processor in an MP configuration. 


OSPoint (CMS dump only) 

Displays the formatted contents of three pointers used in OS simulation. 


Print 


subcommand 


PRT 


ON 

OFF 

CLOSE 

- 



? 

. 


I L * J ) 

Prints the displayed data. 


(Common) 


QUIT 

Ends the session and returns to CMS. 


(Common) 


Regs (Common) 

Displays the registers, clocks, PSWs, timers, CSW, and CAW. 

RIOblok raddr (CP dump only) 

Displays the RCHBLOK, RCUBLOK, and RDEVBLOK for the specified cuu. 
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DUMPSCAN 


DUMPSCAN (continued) 


Scroll U 
ScrollU 


[ HEX 1 
FORMatJ 


IPCS 

(Common) 


Repeats the most recent DISPLAY or TRACE subcommand with an adjusted address. 
SCROLLU displays the preceding screen of data. SCROLL displays the next full screen of 
data. The HEX/FORMAT subcommands are only valid following trace entry displays. 


SYMP 


Formats and displays the summary of the symptom record. 


(Common) 


Trace 


[ [FOR]count] [FROM fromloc] 


’HEX (CP and TSAF dumps only) 
,FORMat, 


[Scroll [U]l 
[[ScrollU J 

Displays trace table entries in hexadecimal or formatted display. After the first successful 
invocation of the TRACE subcommand, you can specify either SCROLL operand to move 
forward or back through the trace table. 


USERMAP 

Adds a user load map to the dump being viewed. 


(CMS dump only) 
(CP dump only) 


VIOblok cuu ’userid 

OPERATOR 

Displays the VCHBLOK, VCUBLOK, and VDEVBLOK for the specified cuu and userid. 


Vmblok 


userid 




(CP dump only) 


[sYSSPOOLJ 

Scans the VMBLOK chain and displays userid, VMBLOK address and status of all logged-on 
users. Displays formatted information from a specified user's VMBLOK by specifying the 
userid operand. 


ECHO CP Class G 

Returns data directly to the terminal a specified number of times. 

ECho f nnl 
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EDIT 


EDIT CMS 

Invokes the VM/SP System Product editor in CMS edit or (EDIT) migration mode. 

Note: In all formats of the CMS EDIT subcommands and macros, use of the word “subcommand 1 ’ 
means a CMS EDIT subcommand only. 

Edit fn ft [fm|*] [(options...!)]] 

options: 

[LRECL nn] [NODISP] 

The format of each EDIT subcommand and macro is followed by its description: 

$DUP [1|n] 

Duplicates the current line. This is a macro. 


$MOVE 



Moves n lines up m or down m lines. This is a macro. 


Displays the last executed EDIT subcommand except for the REUSE{ =) 
or ? (question mark) subcommands. 

ALter charl char2 n 

Scans n records, altering the specified character. 
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EDIT 


EDIT (continued) 

AUTOsave [n|OFF] 

Saves the file after the indicated number of changes or displays the current setting. 
BAckward [JJn] 

Repositions the current line pointer toward the top of the file. 

Bottom 

Moves the current line pointer to the last line of the file. 

CASE [U|M] 

Translates to uppercase. 


Change [/stringl(/string2[/ 



]]] 


Changes stringl to string2. 


CMS 

Enters CMS subset command mode. 


DELete [n | JL| *] 

Deletes n lines or to EOF. 


DOwn [n|.l] 

Moves the current line pointer to the nth line down from the current line. 


DString /[string /]] 

Deletes lines from the current line down to (but not including) the line that contains the 
designated string. 


CMS 
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EDIT 


EDIT (continued) CMS 

FILE [fn [ft [fm ]]] 

Saves the file edited on disk and returns to CMS mode. 

Find [line] 

Searches the file for the specified line. 

FMode [fn] 

Resets or displays the filemode. 

FName [fn] 

Resets or displays the filename. 

FORMat {DISPLAY|LINE} 

Changes the mode of displaying data on a 3270 terminal from typewriter (line) style to 
full-screen display style or vice versa. 

Forward [J. | n] 

moves the current line pointer forward n lines. 



Inserts some or all of the specified file. 

1 Operands are positional. 

IMAGE [ON|OFF|CANON] 2 

Expands text (including backspace and tab) into line images or displays current settings. 

2 ON is the default for all filetypes except SCRIPT. CANON is the default for SCRIPT files. 
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EDIT 


EDIT (continued) 

Input [line] 

Inserts a line into the file or enters input mode. 


LINEmode 

LEFT 

RIGHT 

off' 


L I 

1 R 



Sets or cancels line-number editing, or displays current setting. 

3 Line-number editing is the default for USBASIC and FREEFORT files. 

[Locate]|/[string[/]] 

Scans the file for the first occurrence of a string. 


LONG 

Enters LONG error message mode. LONG is the default mode. 
Next [n|lj 

Advances the current line pointer n lines toward the end of the file. 

Overlay [line] 

Replaces all or part of the current line. 

PREserve 

Saves current mode settings. 

PROMPT [nI 10] 

Sets the line increment for line-number editing. 


QUIT 

Terminates the EDIT session leaving the previous copy of the file intact. 


CMS 
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EDIT 


EDIT (continued) 

RECfm [F|V] 

Sets or displays record format. 


RENum 

strtno 

'incrnoll 


10 

STRTNOJ 1 


Recomputes line numbers. 


REPEAT [n|l|*] 

Executes the following OVERLAY request n times or to EOF. 

Replace [line] 

Replaces the current line with “line” or deletes the line and enters input mode. 
REStore 

Restores mode settings. 

RETURN 

Returns to EDIT environment. 

REUSE [subcommand] 

Stacks (LIFO) the last EDIT subcommand and executes the stacked subcommands. 

SAVE [fn [ft [fm ]]] 

Saves the file on disk. 


CMS 
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EDIT 


EDIT (continued) 

Scroll 1 [*|n|l] 

S [croll]U[p]J 

Displays a number of lines above or below the current line. 
SERial fOFF 

I on r 

I ALL [ 
l seq 

Turns serialization on or off in columns 73-80. 


incrl 

10 J • 

4 


SHORT 

Enters SHORT error message mode. 


STACK [n|i|0|subcommand] 

Stacks n lines in the terminal input buffer. 


TABSet nl [n2 ... nn] 
Sets the specified tabs. 


CMS 


TOP 

Moves the current line pointer to the beginning of the file. 
TRUNC [n|*] 

Sets or displays the column of truncation. 


Type 


Displays the specified number of lines beginning with the current line. 
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EDIT 


EDIT (continued) 

Up [n|l] 

Points to the line n lines above the current line. 


r°N l 

fstartcoll endcol 

[offJ 

l i J * 


Sets, displays, or resets verify mode. 
J [subcommand | n | JL] 


Assigns to X or Y the given EDIT subcommand. 


Zone 


firstcolflastcolj 


l 


Sets or displays the columns to be edited. 

nnnnn \ [text] 
nnnnnnnn J 

Locates the line when using line-number editing. 


CMS 


ENABLE 


CP Class A or B 


Activates communication lines. 

ENable f raddr... 

J Laddr 

1 SNA [userid] 
l ALL 
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ERASE 


ERASE CMS 

Deletes files from a user's disk. 

ERASE £fmj [(options...!)]] 

options: 

[Type I Notype ] 


ESERV CMS 

In CMS/DOS, copies edited DOS/VSE macros from system or private source statement E 
sublibraries to CMS disk files; or lists de-edited macros. 

ESERV fn 


ETRACE 


GCS 


Enables or disables the recording of events in a spool file for a virtual machine or virtual machine 
group. 


ETrace 


DSP | 

EXT i 

FRE 

GET 

I/O 

PRG 

SIO 

SSS 

SVC 

GTrace 


OFF 


[GRoup] 


[ ALL] 


[ END ] 
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EXEC 


EXEC CMS 

Executes one or more CMS commands or EXEC control statements contained in a specified System 
Product Interpreter, CMS EXEC, or EXEC 2 file. 

[EXec] fn [args...] 


The formats of the EXEC control statements are followed by their descriptions: 

^variable = {ae|string|function|X'xxxxxx} 

Assigns a variable. 

&ARGS [argl [arg2 ... [arg30]]] 

Defines or redefines arguments to special variables &1-&30. 

&BEGEMSG [ALL] 

Displays the following unscanned error message lines at the terminal. The list of lines to be 
displayed must end with an &END control statement. 

Note: See the &EMSG statement for the format of message lines. 

&BEGPUNCH [ALL] 

Punches the following lines into cards. End the list of lines with an &END control statement. 
&BEGSTACK [LIFO I FIFO ] [ALL] 

Stacks lines into the terminal input stack. The list is terminated by the &END control 
statement. 

&BEGTYPE [ALL] 

Displays lines at the terminal. The list is terminated by the &END control statement. 
&CONTINUE 

Provides a branching address for EXEC branch statements. 
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EXEC 


EXEC (continued) 


&CONTROL 


OFF TIME 

ERROR NOTIME 
ALL 1 
CMS 


NOPACK 

PACK 


I nomsg] 
MSG J 


CMS 


Specifies the data to be displayed in the execution summary of an EXEC. 

&EMSG mmmnnns [tokl...[tokn]] 

Displays a line of tokens to be edited as an error message. 

SEND 

END statement for action started by &BEGPUNCH, &BEGSTACK &BEGEMSG, or &BEGTYPE. 

&ERR0R [executable-statement| ^CONTINUE ! 

Provides error processing. 

&EXIT [return-code|0] 

Exits from the EXEC file with a specified return code. 

&GOTO {TOP|line-number|-label} 

Transfers control to a specified location. 

&HEX {ON I OFF] 

Initiates or terminates hexadecimal conversion in an EXEC procedure. 


ftokll operator ftok2l 

It! 1 h \ 


executable-statement 


Allows statement execution if the comparison is satisfied. If the comparison is invalid, 
execution continues with the statement following the &IF statement. 


SLOOP 


P f n Urn l 

\-labelJ tcondition] 

Describes a loop in an EXEC, and conditions for exit from the loop. 
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EXEC 


EXEC (continued) 

&PUNCH [tokl [tok2 ... [tokn]]] 
Punches a card with the specified tokens. 


&READ 


n 

ARGS 

VARS[&var1[&var2 
1 


[Svarn]]] 


Reads the next line (or lines) from the terminal stack. 


&SKIP [n|1] 

Skips subsequent statements. 


&SPACE [n|1] 

Displays blank lines at the terminal. 


&STACK 

fFIFOl 

tokl[tok2 ... [tokn]] 


LlifoJ 

HT 



RT 


Places a line of tokens in the console input stack. 


&TIME [ON|OFF|RESET|TYPE] 

Displays time information on the terminal after each CMS command is executed. 


&TYPE [tokl [tok2 ... [tokn]] 

Displays the specified tokens at the terminal. 


CMS 
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EXEC 


EXEC (continued) CMS 

The formats of EXEC built-in functions, followed by their descriptions, are: 

Svariable = &CONCAT tokl[tok2 ... [tokn]] 

Concatenates two or more tokens and assigns the result to a variable symbol. 

^variable = &DATATYPE token 

Determines whether the specified token is alphabetic or numeric. 

Svariable = &LENGTH token 

Indicates number of non-blank characters in the specified token. 

[...] &LITERAL token [...] 

Allows the use of the literal value of the token without symbolic substitution. 

Svariable = &SUBSTR token i [j] 

Extracts a character string from the specified token. 

The formats of EXEC special variables, followed by their descriptions, are: 

&n 

Represents the numeric variables &1 through &30. 

&* and &$ 

Used to perform a collective test on all arguments passed to EXEC. 

&0 

Contains the filename of the EXEC file. 

SDISKx 

Used to determine whether a disk is an OS, DOS, or CMS disk. 

&DISK* 

Contains the mode letter of the first read/write disk in the CMS search order (or contains the 
word NONE). 

&DISK? 

Determines which of the user's accessed read/write disks has the most space. 


&DOS 

Indicates the current status of the CMS/DOS environment (ON or OFF). 
&EXEC 

Indicates the filename of the EXEC file. 
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EXEC 


EXEC (continued) CMS 

&GLOBAL 

Indicates the recursion level of the EXEC procedure that is currently executing (maximum 19 
levels). 

SGLOBALn 

Represents the numeric variables &GLOBALO through &GLOBAL9. 

&INDEX 

Indicates the number of arguments passed to the EXEC procedure (maximum - 30). 
&LINENUM 

Indicates the current line number in the EXEC file. 

&READFLAG 

Indicates the word STACK if there are lines stacked in the terminal input buffer, or the word 
CONSOLE if a read is to be issued to the terminal. 

&RETCODE 

Indicates the return code from the most recently executed command. 

&TYPEFLAG 

Indicates one of two literal values: RT (resume typing) or HT (halt typing). 


EXEC RSCS 

Executes a sequence of commands contained in a CMS “exec” file that is accessable to the RSCS 
virtual machine. 

EXec filename [arguments...] 
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EXEC 2 


EXEC 2 CMS 

Invokes EXEC 2 files. 

EXEC filename [argl [arg2 ... argn]] 

The formats of the EXEC 2 predefined variables, followed by their descriptions, are: 

& 

Initializes to its own name. This variable is initialized or maintained automatically. 

&0 

Initializes to the first word of the command string passed to the EXEC 2 interpreter. This 
variable is initialized or maintained automatically. 

& 1 , & 2 , ... 

Initializes to the arguments argl, arg2,.... argn since they themselves are arguments and 
then are passed to the EXEC 2 file. 

&ARGSTRING 

Initializes to the argument string passed to the EXEC 2 file. This variable is treated as a 
single literal string. 

&BLANK 

Assigns the value of a blank. 

&CMDSTRING 

Initialized to the untranslated command string that is passed to the EXEC 2 file. 

&COMLINE 

Initializes to zero and keeps the line number of the last EXEC 2 file issued command or 
subcommand. 

&DATE 

Evaluates true date (primary meridian -- GMT) in the form: YY/MM/DD. See also &TIME, 
below.) 
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EXEC 2 


EXEC 2 (continued) CMS 

&DEPTH 

Keeps number of user-defined function and subroutine invocations to which return has not 
yet been made. 

&FILEMODE 

Initializes to third qualifier of EXEC 2 file. 

&FILENAME 

Initializes to first qualifier of EXEC 2 file. 

&FILETYPE 

Initializes to second qualifier EXEC 2 file. 

&FROM 

Initializes to zero and keeps line number of last executed &GOTO statement of EXEC 2 file. 
&LINE,&LINENUM 

Keeps current line number of EXEC 2 file. 

SLINK 

Keeps line number from which the currently executing user-defined function or subroutine 
was invoked, or is zero. 

&N,&INDEX 

Keeps the number of EXEC 2 arguments set (See &1, &2, ... &n, above.) 

&RC,&RETCODE 

Initializes to zero, and keeps return code from last EXEC 2 issued command or subcommand. 
&TIME 

Evaluates true time-of-day (primary meridian - GMT) in the form: HH:MM:SS. (See also 
&DATE, above.) 

Note: An asterisk (*), a hyphen (-), or an ampersand (&) starting a command must be given as an 
argument. 
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EXEC 2 


EXEC 2 (continued) CMS 

The formats of the EXEC 2 control statements, followed by their formats are: 

&ARGS [wordl [word2 ...]] 

Assigns wordl, word2, ...wordn to arguments &1, &2, ... &n and discards previously set 
arguments. 


&BEGPRINT 

n 

M 

&BEGTYPE 

label 

1 
. * 

l-l 


linel 

line2 

Prints linel, Iine2, ... linen, truncated at column k if necessary. Does not remove surplus 
blanks or replace any EXEC 2 variables. 


&BEGSTACK 



linel 

line2 

Places linel, Iine2,... linen, in the program stack, truncated at column k if necessary. Does 
not remove surplus blanks or replace any EXEC 2 variables. 
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EXEC 2 


EXEC 2 (continued) 


CMS 


&BUFFER n [commentj 


Discards lookaside buffer and its contents, then creates a new lookaside buffer for either 
designation. 


&CALL line-number argl [arg2 . . .1 
label I 1 1 J 


label ^ ' J 

Invokes the routine located at the specified label or line number and creates a new 
generation of the EXEC 2 arguments &1, &2,&n initialized to argl, arg2,argn. Control 
is returned via the &RETURN statement. 


&CASE 


comment 


Translates any lowercase alphabetic character to uppercase or allows mixed cases. If U or 
M is not specified, the current setting is not changed. 

&COMMAND wordl [word2 . . . ] 

Issues the command comprising of wordl, word2.each with one space between. 

&CRASH [text] 

Aids debugging the EXEC 2 interpreter DMSEXE. Intended to to be used by system support 
people only. 

&DUMP ARGS 

VAR[S] [varl [var2 ... ]] 

Prints a line for each &1, &2, ..., &n argument or variables varl, var2, .... varn. 
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EXEC 2 


EXEC 2 (continued) CMS 

&ERROR action 

Sets the action to be automatically invoked on return from any command(s) or 
subcommand(s) that has a nonzero return code. 


StEXIT ^return-code JcommentJj 

Stops execution of the EXEC 2 file and yields the given numeric return code within the host 
system acceptable range. 

&GOTO line-number [comment] 
label 1 J 

Transfers control to the designated line number or to the line with the label. The first 
character of label must be a hyphen. 


&IF wordl =|EQ 
~i= | NE 
<= | LT 

<= | ~i> | LE | NG 
> | GT 

>=| "i< | GE | NL 


word2 executable statement 


Executes the given executable statement if the condition is satisfied; otherwise, proceeds to 
next statement. 
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EXEC 2 


EXEC 2 (continued) 


CMS 


SLOOP n m 

label * 

WHILE condition 
UNTIL condition 

Loops through the designated operands until specified condition is satisfied. 

Note: When condition is given, the operands are the same as given in the &IF statement. 

&PRESUME f &COMMAND 1 

[&SUBCOMMAND environment] 

Presumes that any statement without a beginning ampersand is to be issued to CMS or to the 
designated subcommand environment. 


SPRINT 

STYPE 


Jwordl [word2 . . .]j 


Prints or types a line containing the operand(s) each separated by one blank, or prints or 
types a blank line if no operand appears. 


SREAD f n 
1 
•k 


ARGS 

VAR[S] fvarl (var2. 

I* [*...] 


.] 


[string var J 

Reads from the console stack (if stack is not empty); otherwise, reads from the console the 
number of lines indicated, or assigns values as designated. 
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EXEC 2 


EXEC 2 (continued) CMS 

&RETURN [word] [comment] 

Returns control to the most recently invoked subroutine to which no return has as yet been 
made. 


&SKIP 


^comment 


i] 


Skips the designated number of lines dependent on whether it is a positive or negative 
number. If it is equal to zero, control goes to the next line. If it is negative, control goes to 
the statement that precedes the &SKIP statement. 


&STACK 

f FIFOl 

Iwordl [ 


[LIFOJ 

L 1 



Places a line in the program stack that contains word(s) that are separated by one space or 
stacks a null line if no words are given. 


&SUBCOMMAND environment [wordl [word2 ...]] 

Issues the designated subcommand comprised of wordl, word2,.... separated by one space, 
to the appropriate environment. 


&TRACE 


ON 

ERR 

ALL 

OFF 


output-actionl 


Traces commands and subcommands as indicated by the trace setting. Information obtained 
is passed to the destination determined by output action. 


Note: Initial trace setting is OFF. Default is asterisk (*), which means current setting remains 
in effect. Initially, output action is set to &PRINT. 
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EXEC 2 (continued) CMS 

&TRUNC ^comment 

Sets the truncation column to k or the maximum value (*). If no argument is shown, the 
previous setting stays in effect. 


SUPPER ARGS 

VAR[S] [varl [var2 ...]] 

Translates any lowercase alphabetic characters to uppercase in the values of &1, &2, ... &n 
or the values of varl, var2, .... varn. 

The formats of the EXEC 2 predefined functions, followed by their descriptions, are: 


& CON CATENATION OF wordl word2 ... 

&CONCAT OF L 1 J J 

Concatenates the word(s) with no intervening space into a single word. If no word(s) appear, 
a null line results. 

^DATATYPE OF [word] 

&TYPE OF 1 J 

Yields the value NUM if word represents a valid signed or unsigned number; otherwise, the 
value is CHAR. 


&DIVISION OF dividend divisor 
&DIV OF 

Yields a numeric value representing the integral part of the division of the dividend by the 
divisor. 
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EXEC 2 


EXEC 2 (continued) CMS 

&LEFT OF word j 

Left-justifies word of length j. Truncates or pads with blanks on the right-hand side. 

&LENGTH OF [word] 

Gives either the number of characters in word or zero if word is not given. 

&LITERAL OF [string] 

Gives the literal string beginning with character after blank following OF and ending with the 
last non-blank character. 

Note: Any leading or embedded blanks are retained and search for replacement variables is 
suppressed. 

&LOCATION OF needle [haystack] 

Searches haystack for first occurrence of needle and gives the starting position number, or 
gives a zero when there is no matching string, or needle exceeds length of haystack, or a 
word is not given. 


&MULTIPLICATION OF i j [k...l 

&MULT OF 

Yields numeric value that results from the multiplying of given numeric signed or unsigned 
words. 


Note: There must be at least two of these. 

&PIECE OF word i [j1 
&SUBSTR OF [l] 

Extracts part of word starting at character i for length j or to end of word. 


Note: Value of i must be numeric positive and j must not be negative. 

&POSITION OF word [wordl [word2 ...]] 

Compares and tries to match word with wordl, word2,.... If match occurs, gives numeric 
value of position of matching word. If no match is made or if there is no word(s) with which to 
compare, the result is zero. 
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EXEC 2 


EXEC 2 (continued) CMS 

&RANGE OF stem i j 

Yields a string comprising of words made by appending numbers to the stem ranging from i 
to j with one blank between each or, if i is greater than j, yields a null string. 

Note: Appended numbers are stripped of any plus sign or redundant leading zeros. 

&RIGHT OF word j 

Right-justifies word of length j. Truncates or pads with blanks on left-hand side. 

&STRING OF [string] 

Gives the string beginning with character after blank following OF and ending with last 
non-blank character. 


&TRANSLATION 
&TRANS OF 


OF wordl 


£word2 


[word3 


i] 


Compares each character in wordl with word2. If a match is found, the position of that 
matching character in wordl is replaced with the character in the same position from word3. 

&TRIM OF [word] 

If word has trailing blanks, removes them. If word is not given, result is a null line. 


&WORD OF [wordl [word2 ... ]] i 

Gives the ith word in the list of words unless the number given is zero or exceeds the number 
of words in the list. 


The format of EXEC 2 User-Defined function, followed by its description, is: 


line-number OF I argl 
label OF l 


[arg2.. .]] 


Invokes the given function by transferring control to the given line number or label and 
creates a new generation of EXEC 2 arguments &1, &2, ... &n initialized to argl, arg2,... argn. 
Control is returned via the &RETURN statement. 
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EXECDROP 


EXECDROP CMS 

Removes the specified EXEC(s) and Editor Macros(s) from storage or discontinues use of the 
specified EXEC(s) and Editor Macro(s) in an Installation Discontiguous Shared Segment (DCSS). 


EXECDrop 

EXDrop 


{ 


execname 1 f 

J l 


exectype 

* 


] 


[ (options...[)]] 


options: 

[User] 

[SYstem] 

[SHared] 
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EXECIO 


EXECIO 


CMS 


Do I/O operations between a device and the program stack. 


EXECIO 


{ lines] 

* J 


DISKR 

CARD 

CP 

DISKW 


PUNCH 

PRINT 

EMSG 


option formats: 


fn ft [fm [linenum]] [([FINIs] 

options [a] [b] [)] 

[( options [a] [b]] [)] 

[( options [a] [b] [d]] [)] 

fn ft fm [linenum 

[recfm [lreci]]] [([FINIs] 

options [b] [c] [d]][e]] [)] 

[( options [b] [c) [d]] [)] 

f(fcc code 1 options [b] [c] [d])l 

l l DATA J J 

[( options tb] (c] (d]] ()] 


(a) 


Find /chars/ ' 
LOcate /chars/ 
Avoid /chars/ 
Zone 


irr} 


LIFO 

IFIFO 

SKip 


(b) 

^Margins ^nl n2jJ JcAse |U|j [STri 


(c) 


(d) 


ng xxx. 


(e) 

[BUFfer length] 


[STRIP] 

[NOTYPE] 


ISTEm 

xxxxl 

jvAR 

xxxxj 


Note: Parsing of the EXECIO command differs from that of other CMS commands in that it involves 
handling of strings that may contain embedded blanks, parenthesis, other special characters, and 
words of more than eight characters. Therefore, if a right parentheses is used to mark the end of 
an EXECIO option, it must be preceded by at least one blank character. A right parenthesis cannot 
be used to mark the end of the STRING option. 
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EXECLOAD CMS 

| Loads the specified EXEC or Editor Macro into storage and prepares it for execution. 

EXECLoad (fn ft) [fm [execname [exectype ]]] [(options...[)]] 

EXLoad 

options: 

[ User 1 
SYstemj 

[Push] 


EXECMAP CMS 

| Provides a list of the EXEC(s) and Editor Macro(s) in storage and in an Installation Discontiguous 
Shared Segment (DCSS). 


EXECMap 

EXMap 



[ (options...[)]] 


options: 

[User] 

[SYstem ] 

[SHared] 

[STACK FIFO 1 LIFO] 
[FIFO] 

[LIFO] 
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EXECOS 


EXECOS CMS 

Resets the OS, VSAM, and Vector environments under CMS without returning to the interactive 
environment. It can be invoked without specifying parameters or by preceding any CMS command 
with EXECOS. 

EXECOS [cmd [operandl [operand2 ...operandn]]] 


EXECSTAT CMS 

Provides the status of the specified EXEC. The status is returned in the form of a return code in 
register 15 as follows: 


0 - EXEC is in storage, and register 1 contains pointer to the fileblock. 
4 - EXEC is not in storage but does exist on dasd, and register 
1 contains pointer to FST. 

8 - EXEC is not in storage and does not exist on dasd. 


EXECStat 

EXStat 


{ 


execname 

★ 



exectype 

★ 


} 


EXECUPDT CMS 

Applies updates to a System Product interpreter source program and creates an executable version 
of the program. It can only be used with System Product interpreter programs. 

EXECUPDT fn [ft f fm l| t(options...[)]] 

[ EXEC J I 


options: 

[CTL fnl] fHISTory 1 fCOMPress 1 fCOMMents 1 [ETMODE] 

[ NOHISTorv j [NOCOMPressJ [NOCOMMentsJ 

[ SID I [NOUPdate] 

nosidJ 
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EXPAND 


EXPAND CMS 

Lets you add space to a program in object deck form. 

EXPAND fnl [ftl [fml [fn2 [ft2 [fm2]]]]] [(options...[)]] 

options: 

[ INPUT filename *] [PRINT | NOPRINT] 

CSECT csect SIZE size] 

Control Statements 
EXPAND csect size (, csect size...] 


EXTERNAL CP Class G 

Simulates an external interruption condition on the virtual machine and returns control to that 
machine. 

EXTernal f code! 


F CMS Border Command 

Scrolls the window forward. 

F 
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FETCH 


FETCH CMS 

Loads an executable phase into storage for execution. 

FETch phasename [(options...[)]] 

options: 

[START] 

[COMP] 

[ORIGIN hexloc] 
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FILEDEF 


FILEDEF 


Simulates OS JCL (Job Control Language) data definition (DD) statements. Displays current 
definitions when entered without operands. 


Flledef 


( ddnameI 

“ j 


Terminal [(optionA optionD[)]] 


PRinter 

[(optionA 

OPTCD 

PUnch 

[(optionA 

[)]] 

Reader 

[(optionA 

[)]] 

DISK f fn 

ft [ 

HI 

1 FILE ddname 1 

M 

or * 

i 

J J 


[(optionA optionB [)]] 


DISK 

DISK 


[[ fn ft ][fmll 

FILE ddname II A1 1 I 


DSN ? 

DSN quail qual2... 
DSN quail.qual2... 
[option A optionB[)]] 


or 

DISK vaddr 

DUMMY [ (optionAO ] ] 


TAPn 


LABOFF 
BLP[n] 

SL[n] [VOLID volid][DISP MOD] 
SUL[n] [VOLID volid] 

NSL filename 
NL [ n ] 


[(optionG[)]] 


GRAF 

CLEAR 


[(optionA optionC optionE optionF[)l 
[([PERM] [ CHANGE I NOCHANGE1)]] 


CMS 
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FILEDEF (continued) CMS 

optionA: 

[PERM] [CHANGE |NOCHANGE] 

[RECFM F|FB|V|VB|U|VS|VBS|FS|FBS|A|M 3 
[LRECL nnnnn] [ BLOCK|BLKSIZE nnnnn] 


optionB: 

[KEYLEN nnn] [XTENT nnnnn|50 ] [CONCAT] 

[LIMCT nnn] [OPTCD a] 

[DISP MOD] [MEMBER membername] 

[DSORG {PS|PO|DA}] 

optionC: 

[7TRACK|9TRACK|18TRACK] [TRTCH 0|OC10T|E|ET ] 
[DEN {200|556|800|1600|6250|38K}] 

optlonD: 

[ UPCASE ILOWCASE] 

optionE: 

[LEAVE] 

[NOEOV] 

| optionF: 

! [ alt (r}] 

| optionG: 

[ (SYSPARM j (string) 

l (?) 
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FILEDEF 


FILEDEF 


Defines CMS format files and spool files. 


FILedef 


PRinter [optionA OPTCD j[)]] I 


f ddnameL 

PUnch [(optionA[)]] 

Reader 

DISK [fn ft f fm V 

[(optionA optionB[)]] 

i 

1* J 

I FILE ddname [aiJ 

DUMMY [(optionA!)]] 

CLEAR 

d 


GCS 


optionA: optionB: 

[PERM] [DISP MOD] 

[DSORG PS] 

[ CHANGE 1 
NOCHANGEj 

[RECFM a] 

[LRECL nnnnn] 

[ BLOCK nnnnn 1 
BLKSIZE nnnnnj 


Note: The above operands work in the same manner as the CMS FILEDEF command. However, 
only the operands and options shown are allowed. (For RECFM, only F, FA, FB, FBA, U, UA, V, VA, 
and VBA are allowed.) 


FILELIST CMS 

Lists information about CMS disk files, with the ability to edit and issue commands from the list. 

FILEList [fn [ft [fm]]] [(options...[)]3 

options: 

[Append] 

[Filelist | Nofilelist ] 

[PROFile fn] 
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FINIS 



FORCE CP Class A 

Forces logoff of the named user. 

FORCE userid 
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FOR MAT-ALLOCATE 


FORMAT-ALLOCATE Service Aid 

Formats, allocates, and labels direct access volumes for paging, spooling, and CP file residence. 

Format Service Aid Control Statements 
•Format Function 

FORMAT,devadr,devtype,startadr,endadr,volser 

•Allocate Function 

ALLOCATE,devadr,devtype,volser 

TEMP,startadr,endadr 

PERM,startadr,endadr 

TDSK,startadr,endadr 

DRCT,startadr,endadr 

DUMP,startadr,endadr 

PAGE,startadr,endadr 

END 

•Label Function 

FORMAT,devadr,devtype,volser,LABEL 


FREE 


Releases previously held user spool files. 


FRee 


userid 


Printer 

PUnch 

ALL 


CP Class D 


FREE RSCS 

Resumes transmission on a communication link previously in HOLD status. 

FRee [linkid] 
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FWDSPACE 


FWDSPACE RSCS 

Causes the file currently being processed to be repositioned in a forward direction. This command 
is for RJE, 3270P, SNA3270P, and MRJE type links. 

FWdspace [linkid] [nnn] 


GDUMP GCS 

Produces a copy of the contents of your virtual machine's storage. 

GDUMP 


T hexlocll f f 

-1 r hexloc21 1 

Tto * 1 

[DSS] [FORMAT type! 

l 0 J [l 

: j [END I I 

[to userid I 

[ GCS 

J l- J J 

b J 

i J 


.bytecount 


GENDIRT CMS 

Creates auxiliary module directories. 

GENDIRT directoryname [targetmode[sourcemode]] 


GENIMAGE CMS 

Presents input control file to the OS utility program IEBIMAGE. Creates text files used by the 3800 
printer. 

GENIMAGEf f n 1 fft Kfmirsfn 1 

[ sysin ] [filej [* J[sysprintJ 



130 VM/SP Quick Reference 






GENMOD 


GENMOD CMS 

Generates a nonrelocatable (MODULE) file on a CMS disk. 

Genmod [fn [MODULE [fm|Al]]] [(options...[)}] 

options: 


[map 1 

[STR I 

[FROM 

entryl] [SYSTEM] 

' os ' 

[nomapj 

[nostrJ 



DOS 



[TO 

entry2] 

L ALL . 


| GENMSG CMS 

| Converts a message repository file, made via XEDIT, into an internal form. Each record is read 
| tfrom the input file, its syntax is checked, and it is placed in an output file in a form the message 
| processor can use. 


GENMSG 

fn ft fm 

applid 

[langid] [(options .. 

. [)]] 

options: 





[CP] 

[ Dbcs 

IfList 1 

[Xref 1 



|_NODbcs 

|[NOListJ 

[NOXrefJ 



Object *1 [Margin nnl 
NOObiectj [ Margin 12 J 


GEN3705 CMS 

Invokes 3705 Stage 2 service aid. 

GEN3705 fname ftype [fmode] [(options...)] 
options: 


RUN ' 

[SAVE 1 

NORUN 

[nosaveJ 
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GET VSCREEN 


| GET VSCREEN 


Writes data from a CMS file to the specified virtual screen. 


GET VSCreen 


vname fn ft 


l 


fm Ifromrec 


-i 


imrec Tnumrecl 1 

i L * JJ 


CMS 


GLOBAL CMS 

Specifies CMS or CMS/DOS libraries to be searched for macros, copy files, subroutines, or DOS 
executable phases when processing CMS commands. 

GLobal f MACLIB ^ [libnamel ... Iibname63] 

I TXTLIB I 
1 DOSLIB | 

IloadlibJ 


GLOBAL GCS 

Defines the CMS load libraries you want searched for modules. 

| GLOBAL LOADLIB [libnamel ... Iibname63] 
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GLOBALV 


GLOBALV CMS 

Set, maintain, and retrieve a collection of named variables. 


GLOBALV 


INIT 
SELECT f group 


[ group 1 
unnamed ] 


SELECT group 

UNNAMED 


SET 

SETS ^namel[valuel][name2 value2].. .} 
SETP 


SETL 

SETLS 


SETSL |name [value]} 


SETLP 

SETPL 


LIST (namel [name2]...] 
STACK {namel [name2]...} 


SELECT group 

UNNAMED 


SELECT (group \ 
\ UNNAMED] 


t'U i 

PUTS {namel [name2]...j 


STACKR 

PUT 
PUTS 
PUTP 

GET [namel [name2]., 
PURGE 


GRPLIST I 

GRPSTACK I 

PURGE 

Note: Although this command may be used in CMS EXECs, it is designed for use with EXEC 2 or 
REXX EXECs. Restrictions/precautions are listed in "Usage Notes for the CMS EXECs." 
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GTRACE 


GTRACE 

Provides additional tracing through VM/GCS. 

GTrace T ON 1 

[oFFj 

RSCS 

H 

CMS Border Command 

Hides the window. 


H 


HALT 

CP Class A 

Stops any active channel program on the real device specified. 


HALT raddr 


HB 

CMS Immediate Command 


Halts the execution of CMS batch virtual machine at the end of the current job. 

HB 
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HELP 


HELP 


| Displays information about commands, instructions, and messages. 


Help 


TASKS 

Help 

taskname TASKS 
menuname MENU 

component-name command-name 


MESSAGE message-id 
MSG 


options: 
optionA: 


* BRIef 

DETail 

^RELated^ 


[ ([optionA] [optionB][optionC][)]]] 


optionB: [ ALL ] 

[DESCript] 

[FORMat] 

[PARMs] 

[OPTions] 

[NOTES] 

[ERRors] 


optionC: 



[EXTend] 


CMS 


HELPCONV CMS 

Converts the specified file into a formatted HELP file. 

lemodel 


HELPCONV filename filetype 


[■ 


HI CMS Immediate Command 

Halt interpretation command causes all currently executing System Product interpreter or EXEC 2 
programs or macros to terminate execution without destroying the environment (as HX would). 

HI 
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HIDE WINDOW 


| HIDE WINDOW CMS 

| Prevents the specified window from being displayed and connects the window to a virtual screen. 

| HIDE WINdow jwname [ON vname [line col] ] 

1 l - 


HO CMS Immediate Command 

Halts the current CMS tracing operation. 

HO 


HOLD 


Defers processing of specified spool output. 


HOld 


userid 


Printer 

PUnch 

ALL 


CP Class D 


HOLD RSCS 

Suspends file transmission on a active link without deactivating the link. 

HOld [linkid] [IMMED] 


HT CMS Immediate Command 

Halts displaying at the terminal. 

HT 
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HX 


HX CMS Immediate Command 

Halts execution of the current CMS command or program. 

HX 


HX GCS 

Halts execution of all programs and commands active in a virtual machine. 

HX 


IDENTIFY CMS 

Display or stack userid, nodeid, rscsid, date, time, time zone and day of week. 

IDentify [(options...[)]] 

options: 

STACK FIFO 
LIFO 

FIFO 

LIFO 

TYPE 


IMAGELIB CMS 

Reads control file created by GENIMAGE and loads files into the specified named system. 

IMAGELIB namedsys 
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IMAGEMOD 


IMAGEMOD 


Allows changes to the 3800 named systems. 


IMAGEMOD 


GEN 

ADD 

REP 

DEL 

MAP 


libname[modname[modname]..] 


libname [(options!)]] 


options: 

f TERM 1 
I PRINT! 

Idisk J 


CMS 


IMMCMD CMS 

Establishes or cancels Immediate commands from within an EXEC. Determines whether a 
particular Immediate command has been established or if it has been issued by the terminal user. 


IMMCMD [SET 

CLEAR 

QUERY 

►STATUS. 


name 
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INCLUDE 


INCLUDE CMS 

Brings additional TEXT files into virtual storage. 

INclude fn... [(options...!)]] 


options: 

[ CLEAR 1 [RESET f entry’ll [ORIGIN fhexloc1 1 [START] 
NOCLEAR j [ 1 * J J [ l TRANS J J 

[ TYPE 1[MAP I fINV 1 pREP 1T AUTO 1 T lIBE 1 
NOTYPE J[nOMApJ[nOINVJ[nOREpJ[nOAUTOJ[nOLIBEJ 

[ PUP lfHIST 1 )same] [RLDSAVE] 

NODUPJ [ NQHISTj 


INDICATE CP Class A 

Displays the use of and contention for major system resources. 

INDicate FAVORed 


INDICATE 


Displays the use of and contention for major system resources. 


INDicate 


FAVORed 

I/O 

LOAD 


PAGing TWAITl 

[all J 

Queues 

USER [1 1 

I useridJ 


CP Class E 
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INDICATE 









ITASK 


ITASK 


Invokes other EXECs and commands to do most of the steps in the installation procedure. 


ITASK 


LOAD 


CP 

CMS 

GCS 

HELP 

HPO 

IPCS 

TSAF 

CMSSRC 

CPSRC 

GCSSRC 

IPCSSRC 

TSAFSRC 

CMSFTSRC 


LANG 


BUILD 


’ ALL 
ALLOBJ 
CP 
CMS 
TSAF 
HELP 

. CMSSRC , 

CP [noassem] 

CMS 

GCS [groupname] 


ASSEMBLE 


r ALLCP " 
BMKBOX 
DMKFCB 
DMKRIO 
DMKSNT 
DMKSYS 
. DMSNGP , 


ALLOCATE 

BASEIDS 
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ITRACE 






LANGGEN 


| LANGGEN CMS 

| Combines all the text files created by LANGMERG for a language and saves them in a DCSS named 
| NLSxy, where x is the levelid and y is the langid. LANGGEN also saves CP's message 
| repository for CP to use. 

| LANGGEN langid [levelid] [ ( [CTL filename] [)]] 


| LANGMERG CMS 

| Combines all the language-related files for an application into one text file. (The LANGGEN 
| command can then load this single text file into a DCSS as a language segment.) 

| LANGMERG langid applid [( CTL filename [}]] 


LINK CP Class G 

Permits one user to access minidisks belonging to another user. 

LINK [To] userid vaddrl [As] vaddr2 [mode] [[PASS=] password] 

Note: If password suppression is in effect, the DASD password (access mode password) cannot be 
entered on the LINK command line. The password must be entered after the prompting message: 
ENTER PASSWORD. 


LISTDS 


Displays information about data sets, files, extents, or free space. 


LISTDS 


fdsnamel 

Jf">l 

l * J 

V 1 


[ (options...[)]] 


options: 


[FREE 1 [FORMAT] 
[EXTENTj [PDS] 


CMS 
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LISTFILE 


LISTFILE 

Lists information about CMS files. 


Listfile ffn Fft ffm1 11[(options...[)]] 

l * l* l *JJJ 

options: 


^Header 1 

Exec [Trace] [ARGS] 


FName 

INOHeader1 

Trace[ARGS] 


FType 

L J 

APpend[ARGS] 


FMode 


STACK[FIFO|LIFO] 


FOrrnat 


FIFO 


ALloc 


LIFO 


Date 


XEDIT 


LABEL 


. 


. 


LISTIO 

Displays a list of current assignments for system and/or programmer logical units in a virtual 
machine. 


LISTIO 


SYS 

PROG 

SYSxxx 

A 

UA 

ALL 


[ (options...[)]] 


options: 

f EXEC I (STAT] 
APPEND! 


CMS 


CMS 


144 VM/SP Quick Reference 




LKED 


LKED CMS 

Used to create a CMS LOADLIB or LOADLIB member. 

LKED fn [(options...[)]] 


options: 


[NCAL] [LET] [ALIGN2] [NE] [OL] [RENT] 
[REUS] [REFR] [OVLY] [XCAL] 


[NAME membername] [LIBE libraryname] 


’xref' 

MAP 

LIST 


PRINT ' TERM 
DISK NOTERM 

NOPRINT 


SIZE 

valuel value2 



valuel 



valuel, 



,value2 



* 4 



LOAD 


Brings TEXT files into storage and establishes links. 

LOAD fn ... [(options...[)]] 


options: 


CLEAR 

NOCLEAR 


RESETJentry 


t 

[type 1 [ auto |[] 
[ NOTYPE J [nOAUTOJ[] 

[HIST 1 

[ nohist j 


LIBE 
NOLIBE 


MAP 1 [iNV I[REP 
- I , 0 - 11 - 


NOMAP 


>J [noinvj [norepJ 


ORIGIN 


l 


hexloc 

TRANS 


[START] 


PUP 
NODUP 


[RLDsave] 


CMS 
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LOADBUF 


LOADBUF CP Class D 

Loads UCS (Universal Character Set) buffer or FCB (forms control buffer) on real printer. 

LOADBUF /raddr UCS name [Fold] [Ver] 1 
\ raddr FCB name [Index [nn]]J 


LOADCMD GCS 

Defines a program to be executed as a command. 

LOADCmd name member 


LOADLIB 

Lists, copies, or compresses a CMS LOADLIB. 

LOADLIB FlIST 

COMPRESS J fileidl L I [fileid2[fileid3]] [(options...[)]] 


LIST r ] ' 

COMPRESS J fileidl L [ 
.COPY [ J 


options: 


I TERM I REPLACE 
PRINT I [MODIFY 
DISK J 1 

SYSIN control statements (for COPY only) 
[SELECT|EXCLUDE] 


CMS 


LOADMOD CMS 

Brings a single MODULE file (in nonrelocatable format) into storage. 

LOADMod fn jMODULE [fm 

l l* 
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LOADVFCB 


LOADVFCB 

Specifies the forms control buffer image for a virtual spooled 3203, 3211, 3262, 
printer. 

LOADVFCB vaddr Feb name [Index [nn]] 

CP Class G 

4245, 4248, or 3289E 

LOCATE 

CP Class C or E 

Provides the addresses of CP control blocks related to a specified user, virtual device, or real 
device. 

LOCate f userid [vaddr]! 

| raddr J 

LOCK 

Locks specified pages in processor storage. 

LOCK fuserid 1 firstpage lastpage [MAP] 
l SYSTEM J 

CP Class A 

LOGOFF 

Terminates a terminal session. 

LOGoff [HOld] 

LOGout 

CP Class Any 

LOGON 

CP Class Any 


Initiates all virtual machine operation. 

Logon userid [password] [Noipl] 
Login 
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M (CMS Border Command) 






MAKEBUF 


MAKEBUF CMS 

Creates a new buffer within the program stack. 

MAKEBUF 


MAP IPCS 

Converts various types of load maps into the proper format for use by IPCS. 

MAP type [Prompt] 


| MAXIMIZE WINDOW 


Expands a window to the physical screen size. 

MAXimize WINdow fwname 1 


CMS 


MESSAGE 


Sends text messages to other users, system operator or self. 

1 


Message 

Msg 


ALL 
userid 
* 

Operator 


msgtext 


CP Class A or B 


MESSAGE 


Sends text messages to other users, system operator or self. 


Message 

MSG 



msgtext 


CP Class Any 
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MIGRATE 


MIGRATE CP Class A 

Activates normal page/swap table migration routines or forces the pages of the specified user to a 
secondary device when the user is currently active. 

MIGrate [userid] 


| MINIMIZE WINDOW CMS 

| Reduces the size of the window to one line. 

| MINimize WINdow fwnamel 


MODMAP CMS 

Displays a MODULE file load map. 

MODmap f n 


MONITOR CP Class A or E 

Starts or stops the recording of interruptions and other events that occur in the real machine. 


MONitor 


AUTOdisk J ON \ 
\ OFF J 

CLOSE 


Display 


SPOOL * 

TAPE 

ALL 
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MONITOR 


MONITOR (continued) 


CP Class A or E 


ENable 


PERForm 1 

RESPonse 

SCHedule 

USER 

INSTsim 

DAStap 

SEEKS 

SYSprof 


1 Select one or more of the classes, subject to the restrictions listed with the ENABLE operand. 


INTerval nnnnn T SEclmm 
[ MINJ 


LIMIT n 


NOSTOP 

STOP 

SAMPLE 


SEEKS 


INclude raddr raddr... 
Exclude raddr raddr... 
DELete 
Display 


STArt 


SPOOL [TO userid] [BUFFS n] 

CPTRACE 


TAPE raddr 

*MODE 

■ 800 "1 1 




1600 1 

[BUFFS n] 



6250 1 




. 38K J 
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MONITOR 


MONITOR (continued) 


CP Class A or E 


' 



2 


STOP 

* SPOOL 

1 




CPTRACE 




^ TAPE 

J 


» 

TIME 

’ FROM 

hi:ml TO h2:m2 1 



FOR 

hh: mm 



ALL 





. NONE 


J 



2 See the operand description for the default values. 


MOREHELP 


CMS 


Displays additional information, if available, for a previosly-issued valid HELP command. 

MOREhelp [(optionA optionB [)]] 


optionA: 


BRIef 

DETail 

RELated^ 


optionB: [ALL] 

[DESCript] 

[FORMat] 

[PARMs] 

[OPTions] 

[NOTES] 

[ERRors] 


MOVEFILE CMS 

Moves data from one device to another device. 


MOVEfile inddname 

f outddnamel 1 

((PDson 

INMOVE 

[OUTMOVE J I 
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MSG 


MSG 

Sends a message line to a local or remote operator or user. 

Msg nodeid {useridjSYSTEM} [msgtext ] 

RSCS 

MSGNOH 

CP Class A or B 

Allows a virtual machine to send messages without the standard header associated with the 
MESSAGE command. 

MSGNOH f userid "J msgtext 

[*? \ 

N 

Minimizes the window. 

N 

CMS Border Command 

NAMEFIND 

CMS 


Display/stack information from a NAMES file, (default 'userid NAMES'). 

NAMEFind :tag value [:tag [value]]... [options...!)]] 


options 

= 




STACK 

In | * | 

1 ] 

[FIFO|LIFO] 

[File fn 

FIFO 

[n | * | 

1 1 


[LINenum 

LIFO 

[n|*| 

1 1 


[STARt recnum 

TYPE 

[n | * | 

1 1 


[Size[n|* | 8 


[XEDIT] 
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NAMES 


NAMES 

Display a menu to create, display or modify entries in a 'userid NAMES' file. (The menu is 
available only on display terminals). 

NAMES [nickname] 


NCPDUMP 

Processes CP spool reader files created by 3705 dumping operations. 

NCPDUMP [DUMPxx] [([ERASE] [NOFORM] [NCPBUFF][)]] 


CMS 


CMS 
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NETWORK 


NETWORK 

Controls communications to 370x controllers or resources or 3270 remote equipment. 

NETWORK ATTach resid [To] userid [As] cuu 


DETach resid [From] userid 
DISAble 


[ ALL 1 

resid [resid. . . ]J 

f-tfhexloc2l 

Wipe J 


Display raddr hexlocl 


C.}fbytecountl 

[ end J 


DUMP raddr 


IMMED 

OFF 

AUTO 


ENable T ALL ] 

[ resid [resid...]J 


LOAD raddr ncpname 
POLLdlay nnnn f ALL 1 

[ raddr J 


Query 


ACTive 

OFFline 

FREe 

ALL 

resid [resid...] 


SHUTDOWN 


[ raddr! 
ALL J 


lOFFline 


[resid...] 


CP Class A 
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NETWORK 


NETWORK 


CP Class B 


Controls the 370x control program and Its resources. Also provides a means of altering binary 
synchronous line poll delay interval. 

NETWORK ATTach resid [To] userid [As] cuu 
DETach resid [From] userid 
DISAble 


[ ALL 1 

resid [resid...]I 


p 

Display raddr hexlocl 

o 

‘hexloc2l 

END J 

- 

r i 

C,| 

’bytecountl 

END J 

- 


DUMP raddr 


IMMED 

OFF 

AUTO 


ENable 


ALL 

resid [resid...] 


5id [resi 

LOAD raddr ncpname 

POLLdlay nnnn | ALL 1 
I raddr I 


Query 


ACTive 

OFFline 

FREe 

ALL 

resid [resid...] 


VARY fONIine 1 
\OFFlineJ 


resid [resid... ] 
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NETWORK 


NETWORK 


Starts or ends communications with ACF/VTAM. (For RSCS operator only) 


NETwork 


STArt 


[APPLid name] 
[Pass password] 
[RETry nn] 


l HALT [QUICK] 


RSCS 


NOTE CMS 

Prepare a ‘note’ for one or more computer users, to be sent via the SENDFILE command. 

NOTE [name...[CC:name...]][(options...[)]] 
options: 

I ACk 1 fNOTebook fnlfLOG 1fLONg 1 
I NOAckl I NOTebook * IINOLogl Short I 
' [^NONotebook y * * 

[ADd] [Cancel] [Replace] [PROFile fn] 


NOTREADY CP Class G 

Simulates loss of ready status on virtual device. 

NOTReady vaddr 


NUCXDROP CMS 

Deletes specified nucleus extensions. 

NUCXDROP | name 1 [name2...]J, 
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NUCXLOAD 


NUCXLOAD CMS 

Loads a nucleus extension. 


NUCXLOAD 

f name [fn] 1 

T([SYstem] 

[SErvice] 1 


\ name member ddname J 

[ [ENdcmd] 

[IMmcmd] [Push] [)]J 


NUCXMAP CMS 

Identifies existing nucleus extensions. 

NUCXMAP [([STACK] fLIFOl [)]] 

[fifoj 

O CMS Border Command 

Restores the window. 

o 


OPTION 


CMS 

In CMS/DOS, changes any or all of options in effect for the DOS/VS COBOL compiler. Only 
specified options are changed. 

OPTION [options.. 

.3 

options: 



[ DUMP 1 

[deck 1 

[list 1[listx 1 |sym 1 

1 NODUMP 1 

Inodeck] 

InOLIStJINOLISTXJInOSYMJ 

[XREF 1 

[errs 1 

[48c1[tERM 1 

Inoxref I 

[noerrsI 

I60C JInOTERmJ 

158 VM/SP Quick Reference 







ORDER 


ORDER CP Class D 

Places closed spool files in a specified order by device type. (A combination of CLASS and spoolid 
specifications may be entered.) 


userid 


* > 
Reader|RDR 


CLass cl CLass c2... 


SYSTEM 


Printer|PRT 


spoolidl spoolid2... 


* 


PUnch|PCH 


FORM forml FORM form2 . 

i 

. 


t d 


DEST destl DEST dest2 . 

• • 


Note: Sequencing may be done with the ORDER command using a combination of "CLASS c" 
FORM, and spoolid specifications. 


ORDER CP Class G 

Places closed spool files in a specified order by device type. 


ORDer 

r 

Reader 


CLass cl CLass c2... 

*■ 


Printer 


FORM forml FORM form2.. 

. 


PUnch 


spoolidl spoolid2... 





DEST destl DEST dest2.. 



ORDER RSCS 

Reorders files enqueued on a specific link . 

ORDer [linkid] spoolidl [spoolid2 ...] 


OSRUN CMS 

Executes a load module from a CMS LOADLIB or an OS module library. 

OSRUN member [PARM=parameters] 
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OSRUN 







PEEK 


PEEK CMS 

Display a file that is in your virtual reader without reading it onto disk. 

PEEK [spoolid] [(options...[)]] 

options: 

[FRom recno] 

[FOr numrec] 

[PROFile fn] 


PER CP Classes A,B,C,D,E,F, AND G 

Monitors certain events as they occur during program execution in the user's virtual machine, such 
as: the fetching and execution of an instruction, the execution of a successful branch instruction, the 
execution of an instruction that alters a specific general purpose register, and the execution of an 
instruction in the virtual machine that alters storage. 


event types: 


Instruct [[DATA] hex-data] 

BRanch [[INTO] into-addr-range] 

’ options" 


STore 

[INTO] storage-addr-range 
[INTO] addr [DATA] hex-data 



Mask 

[INTO] addr 

[DATA] mask-field 



G[regl] 

^-jjreg2] 

[[DATA] hexword] 




{.)[regcount] 


- 
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PER 


PER (continued) 


options: 

Range instruction-addr-range 
FRom instruction-addr-range 

PASS j 0 1 

l n l 

CMd {text} 

Printer [ RUN ] 

[ TErminal l NORun 
BOth I RUN 

r TE 1»]| 

GUESTR 

GUESTV 

DATOFF 

DAT 


CP Classes A,B,C,D,E,F, AND G 


sub-commands: 


COunt 

TAble 


SAve traceset-name 
GET traceset-name 
ENd f ALL 


COunt 

Current 

element-number 
event-type 
.traceset name - 


[APpend] 

[Append] 
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POP WINDOW 


POP WINDOW 

Moves a window up in the order of displayed windows. 

POP WINdow fwname\fn1 

1 WM JL-J 

CMS 

POSITION WINDOW 

Changes the location of a window on the physical screen. 

Position WINdow jwname | psline pscol 

CMS 

PRB 

IPCS 


Updates the STATUS, FUNCTN, SEV, or DUP/APAR/PTF field 
problem number or displays a specific problem report. 


PRB 


APAR aparnumber 

CLOSE 

DSPLY 


nnnnn 


1 HELP 


DUPOF (nnnnn | aparnumber} 
IBM 

NEEDINFO 

PTFIS [filename] filetype 
PTFON 

SEV [1234] 

USER 


in a symptom record for a specific 


Note: The sequence of nnnnn and the other keywords can be reversed. However, nnnnn is a more 
recent problem than mmmmm. 
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PRELOAD 


| PRELOAD CMS 

| Collects multiple text files and reformats them into a single text file. 

| PRELOAD loadlist [control] 


PRINT 

CMS 

Directs a specified spool file to the virtual printer. 

PRint fn ft £fmj 

[(options...[)]] 

options: 



[(OVersize) ] 



’CC [HEADer ]1 

Ttrc 1 


NOCC J 

[UPCASE] [NOTRcJ 


LINECOUN fnnl ] 

MEMBER f * 1 1 


l—l J 

Jmembernamej 1 [HEX] 


PROB IPCS 

Creates problem reports and adds information to an existing problem report. 

PROB 
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PROGRAMMABLE OPERATOR 


PROGRAMMABLE OPERATOR CMS 

Anyone, authorized by the active routing table, may execute the programmable operator 
commands. To execute a programmable operator command you must send a message to the 
programmable operator facility virtual machine. The text of the message is the command to be 
issued. Use the CMS EXEC, PROPST EXEC, to invoke the programmable operator facility. 

The format of the invocation EXEC is: 

PROPST I rtable-name | [DISConn] 

I PROP I 

The local format of the message sent to the programmable operator facility is: 

Message userid propcmd [parameters] 

MSG 


The distributed (network) format of the message sent to the programmable operator facility is: 

SMsg netid Msg nodeid userid propcmd [parameters] 

The CMS TELL EXEC may be used by the logical operator instead of either the local or the 
distributed format. 

The format of the TELL EXEC is: 

TELL f nickname 1 message 

\ userid [AT node]] 

The formats of the programmable operator commands are followed by their descriptions: 

CMD vmcmd 

Executes selected CP or CMS commands in the programmable operator's virtual machine. 
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PROGRAMMABLE OPERATOR 


PROGRAMMABLE OPERATOR (continued) 


CMS 


FEEDBACK text.., 

FB 

Places comments about the operation of the system and/or the programmable operator in the 
feedback file. 




GET f FEEDBACK 
\ FB 

LLOG [yymmdd], 

Retrieves one of the programmable operator files: the feedback file (FB) or the log file (LOG). 


LOADTBL [filename] [(RPL[)]] 

Loads a new routing table to control the operation of the programmable operator facility. 

LGLOPR f ASN 1 
\ RLS V 
l RPL J 

Changes the assignment of logical operator of the programmable operator facility. 

LOG text... 

Writes a message to the current day's log file. 

QUERY HOSTCHK 

Indicates node-checking status. 

QUERY LGLOPR 

Indicates the userid and nodeid of the currently assigned logical operator. 


QUERY LOGGING 

Indicates logging status. 

QUERY PROPCHK 

Indicates node-checking status. 

QUERY RTABLE 

Indicates the name of the programmable operator's active routing table. 
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PROGRAMMABLE OPERATOR 


PROGRAMMABLE OPERATOR (continued) 


CMS 


SET DEBUG fON 1 
\ OFF/ 

Enter and exit from programmable operator DEBUG mode. 

SET HOSTCHK JON \ 

JOFFJ 

Restarts or halts checking of the host system by the distributed system. 


SET 


LOGGING f ON I 
\ OFF \ 
l ALL J 

Causes the programmable operator facility to stop writing any messages to the log file. 


SET PROPCHK Jon 1 [nodeid] 
lOFF J [nodeid] 

Restarts or halts checking of the programmable operators on the distributed systems. 


STOP 

Stops operation of the programmable operator. 

Note: The SET DEBUG command may be entered only at the programmable operator virtual 
console. The SET LOGGING, SET HOSTCHK, and SET PROPCHK commands may be entered at the 
programmable operator virtual console, and also from the logical operator's console. 


PRTDUMP IPCS 

Formats and/or prints the symptom record on the first page with a disk dump file previously 
processed by IPCSDUMP. 

PRTDUMP PRBnnnnn [option...] 

CP DUMP options: 

[NOFORM] [NOREAL] [NOVIRT] [NOHEX] (NOMAP] 

CMS DUMP options: 

not available; standard print routine is used. 

partial DUMP options: 

none; standard print routine is used. 
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PSERV 


PSERV CMS 

In CMS/DOS, copies, displays, prints, or punches a procedure from the DOS/VSE procedure library. 

PSERV procedure [ft I PROC ] [(options...!)]] 
options: 

[ DISK ] [PRINT] [PUNCH] [TERM] 


PUNCH 


Directs a specified spool file to the virtual punch. 

PUnch fn ft [fm|*] [(options...!)]] 


options: 



CMS 


PURGE 


CP Class D 


Deletes a closed spool file before reading, printing, or punching occurs. (A combination of CLASS 
and spoolid specifications may be entered.) 


| PURge 


[FORCE] 


userid! 

system! 


Reader|RDR 

ALL 


Printer|PRT 

CLass cl CLassc2...1 


PUnch)PCH 

spoolidl spoolid2 ... 



FORM forml FORM form2 ... 



DEST destl DEST dest2 ... 


ALL 




1 Purging may be done using a combination of CLASS c, FORM and spoolid specifications. 
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PURGE 


PURGE 


CP Class G 


Deletes a closed file before reading, printing, or punching occurs. (A combination of CLASS, 
FORM, and spoolid specifications may be entered.) 


PURge 


* 

Reader 

1 CLass cl CLass c2 .. . 


Printer 

FORM forml FORM form2 ... 


PUnch 

spoolidl spoolid2 ... 


ALL 

ALL 


b 

( DEST destl DEST dest2... 

* 


PURGE RSCS 

Removes and discards all or specified inactive files from a link. 

General User Format: 

PURge [*]spoolid 

Operator Format: 

PURge [linkid] (spoolid [spoolid...] | ALL} 


| PUT SCREEN CMS 

| Makes a copy of the physical screen and writes the image to a CMS file. 

| PUT SCREEN fn ft T fm 1 


| PUT VSCREEN CMS 

| Writes the data from the scrollable data area of a virtual screen to a CMS file. 







■ 

PUT VSCreen 

vname fn ft 

fm 

fromlin 

[ numlin 1 




* 

1 





A1 

• 

i J J 
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QUERY 


QUERY 


CMS 


In CMS or CMS/DOS mode, provides information about the virtual machine environment. 


Query 


ABBREV 

APL 

AUTOREAD 

BLIP 

BORDER wnarae [ALL] 

CHARMODE 

CMSLEVEL 

CMSPF fnnl 

CMSTYPE l * 

CURSOR [[vnamejl 
DISK mode I 


R/W 

MAX 


DISPLAY 

DLBL 

DOS 

DOSLIB 

DOSLNCNT 

DOSPART 

EXECTRAC 

FILEDEF 

FULLREAD 

FULLSCREEN 

HIDE fwname 

l 1 

IMESCAPE 1 

IMPCP 

IMPEX 

INPUT 

INSTSEG 

KEY 

LABELDEF 
LANGLIST 
LANGUAGE [ALL] 
LDRTBLS 


[ (options...[)]] 
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QUERY 


QUERY (continued) 


LIBRARY 
LINEND 
LOADLIB 

LOCATION wname 
LOGFILE vname 
MACLIB 
NONDISP 
OPTION 
OUTPUT 
PROTECT 
RDYMSG 
REDTYPE 
RELPAGE 
REMOTE 

RESERVED wname 
ROUTE fmsgclassl 


SEARCH 

SHOW 


f msgclassl 

l - J 


SYNONYM 


wnamel 

1 J 

SYSTEM! 

USER 

lALL J 


SYSNAMES 

TEXT 

TRANsIate 


TXTLIB 

UPSI 

VSCREEN 

WINDOW 


USER 

‘TRANslate APPLID 

*applidl 1 

SYSTEM 

SYNonym 

L - J 

ALL 

BOTH 

J] 





WMPF 


vname [ALL] 
★ 

wname [ALL] 


nnl 

- J 


options 


STACK fFIFOl 

[lifoj 


FIFO 

LIFO 


CMS 


[ (options...[)]] 
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QUERY 


QUERY 


CP Class A 


Displays system software maintenance information, log messages, the number of logged-on users; 
lists logged-on users. Provides the paging activity index or specified user priority or status of the 
Virtual Machine Assist feature. 


Query 


AFFInity [userid] 

CPAssistl 

J0urnal2 

LOGmsg 

Names 

PAGing 

PRIORity userid 
PROCessr 


QDROP 

SASsistl 


SPMODE 


SRM 


r APAGes > 
DSPSlice 
IB 

MAXDrum 

MAXWss 


MHFULL 

PB 

PCI 

PGMStat 


^ PGMTlim J 
Users [userid] 


1 The collective use of both QUERY CPASSIST and QUERY SASSIST is used to determine the 
current status of the expanded virtual machine assist portion of the Extended Control-Program 
Support:VM/370 

2 The JOURNAL operand is valid only if STQUERY = YES is specified in the SYSJRL macro 
instruction in DMKSYS. 
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QUERY 


QUERY 


CP Class B 


Displays system status, paging, scheduling, machine configuration information, system software 
maintenance information, log messages, the number of logged-on users; lists logged-on users. 


Query 


DAsd Tsysvirtl 


[virtualj 

ACTive 


ATTach 

GRaf 

FREe 

LINES 

OFFline 

UR 

, ALL 

TApes 


ALL 



[PATHS] 


DAsd volid 

DUMP 

Lnnn 

LOGmsg 

MITime 

Names 

PROCessr 

raddrl [-raddr2] 
lprt 

STATUS raddr 
STORage 
SYStem raddr 
TDsk 

Users [userid] 


QUERY CP Class C 

Displays log message, number of logged-on users,the status of CPTRAP, CPLEVEL, specific 
userids, and the on-line processors in the system; lists logged-on users. 


Query 

CPTrap 

STATUS 


- 



SELECT f ALL 

1 




L typenuml [ 

...typenumn] J 



LOGmsg 

Names 

PROCessr 

Users [userid] 
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QUERY 


QUERY 


CP Class D 


Provides data on spooling operations. 


Files [CLass c][FORM form][DEST dest] 


[userid] 


HOld 

NOHold 

SYShold 

USERhold 


Printer/*[CLass c] [FORM form] [DEST dest] userid 
PUnch * 


spoolid 


HOld nul 
NOHold ALL 
SYShold . TBL 
USERhold PSF 


CPLEVEL 

LOGmsg 

Names 


ACTive 

ATTach 

FREe 

OFFline 


[userid] 


1 The options may be specified in any order. 


2 Using a 1-4 digit all numeric userid will cause unpredictable results for the QUERY command, 
which also has a 1-4 digit all numeric spoolid parameter. 
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QUERY 


QUERY 


CP Class E 


Provides the paging activity index or specified user priority or status of the Virtual Machine Assist 
feature. 


Query 


AFFInity [userid] 

CPAssistl 

J0urnal2 

LOGmsg 

Names 

PAGing 

PRIORity userid 
PROCessr 


QDROP 


SASsistl 
SRM f APAGes 

DSPSlice 
IB 


MAXDrum 

MAXWss 


MHFULL 

PB 

PCI 

PGMStat 
^ PGMTlim 
Users [userid] 


1 The collective use of both QUERY CPASSIST and QUERY SASSIST is used to determine the 
current status of the expanded virtual machine assist portion of the Extended Control-Program 
Support:VM/370. 


2 The JOURNAL operand is valid only if STQUERY = YES is specified in the SYSJRL macro 
instruction in DMKSYS. 


QUERY 


Displays log messages, number of logged-on users; lists logged-on users. 


Query 



[userid] 


CP Class F 
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QUERY 


QUERY 


Provides system status and machine configuration information. 


Query 


Time 

Set 

TERMinal 


Files [CLass c] [FORM form] 


NOHold 

HOld 

USERhold 

SYShold 


LOGmsg 



CHANnels 

GRAF 

CONsole 

DAsd 


- 

TApes 

LINES 

- 

[Virtual] 

UR 

STORage 

ALL 

_ vaddr[-vaddr] 

4 


Links vaddr 

CPLANG 

CPLEVEL 

CPUid 

SECuser 

Names 

S370E 


Reader 

[CLass c ] 

NOHold 



all' 

Printer 

[FORM form] 

HOld 



TBL 

Punch 

[DEST dest] 

USERhold 



PSF 


spoolid 

SYShold 




PF [nn] 

SCReen 

PROCessr 

VMSAVE 

SPMODE 


CP Class G 
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QUERY 


QUERY (continued) 


PER 


Current 

Names 

traceset-name 

ALL 


Users [userid] 
USERID 


CP Class G 


QUERY GCS 

Requests information about your GCS virtual machine. 


QUERY 


mode 


DISK 


R/W 

MAX 


DLBL [mult] 
LOADLIB 
FILEDEF 
- SEARCH 
SYSNAMES 
ETRACE 
GROUP 
ITRACE 
LOCK 
REPLY 
LOADCMD 
LOADALL 


The DISK, DLBL, LOADLIB, FILEDEF, SEARCH, and SYSNAMES operands work the same as for the 
CMS QUERY command with the exception that no options are allowed. 
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QUERY 


I QUERY 


TSAF 


Requests information about the TSAF configuration when the TSAF virtual machine is running. 
Only the TSAF virtual console or the secondary user of the TSAF virtual machine can issue this 
command. 


QUERY 


COLLECT 

ETRACE 

LINK 

RESOURCE 


QUERY 

Requests system information for a link, a file, or for the system in general. 


Query 


nodeid 


linkid 


Active 

Def 

Files 

Queue 

Sum 


File 


spoolid 

*spoolid 

★ 


Status 

Rscs 

Vm 


SYstem 


NETwork 

Active 

Dest 

EXits 

LEVel 

LOcal 

Links 

Ports 

Queue 

Routes 

REroutes 


RSCS 
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QVM 



RDRLIST CMS 

Display information about files in your virtual reader with the ability to issue commands from list. 

RDRlist [ (options...[)]] 

RList 

options: 

[PROFile fn] 

[Append ] 
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READCARD 


READCARD 


Reads data from the virtual card reader, and creates CMS disk files containing the data. 



[ (options...()]] 


options: 


Fullprompt 

Minprompt 

NQPrompt 


Replace 

NOReplace 


CMS 


READY CP Class G 

Makes a device-end interruption pending for the specified device. 

READY vaddr 


READY RSCS 

Notifies RSCS that a forms mount has been satisfied, or that a setup page is wanted. This 
command is for RJE, 3270P, SNA3270P, and MRJE type links. 

Ready [linkid] 


RECEIVE 


Read onto disk a file or note that is in your virtual reader. 

RECEIVE (spoolid [fn [ft [fm]]]] [(options...[)]] 


options: 


NOTebook fn 
NOTebook * 



‘Fullpromptl I Replace 
Minprompt I I NOReplace 
^NOPrompt J 


[Purge] 


[STack] 


CMS 


180 VM/SP Quick Reference 







RECONN 


RECONN RSCS 

Reconnects the RSCS operator console after being disconnected and resets the userid, if any, that 
was used on the DISCONN command. (For RSCS operator only) 

REConn 


| REFRESH CMS 

| Updates virtual screen and their associated windows. 

| REFresh 


RELEASE CMS 

Makes a disk and its directory inaccessible to a virtual machine. 

RELease j cuu \ [(DET [)]] 

lmode] 


RELEASE 

Releases a disk. 

RELEASE fcuu \ [(DET[)]] 

JmodeJ 


GCS 


Chapter 4. CP, CMS, GCS, TSAF, RSCS, and IPCS Commands 181 






RENAME 


RENAME CMS 

Changes the name of one or more CMS disk files. 


Rename 

fileidl fileid2 [(options.. 

..[)]] 

options: 



Ttype 1 

TnoupdirtI 


[notype J 

| [uPDIRT J 



REPEAT CP Class D 

Holds or Increases the copies of an output spool file. 


REPeat 

' raddr" 


rnnnl 

U J 


.ip rt . 


Cnnn} HOld 


REPLY GCS 

Replies to messages sent to the GCS operator. 

REPLY id [text] 


REQUEST CP Class G 

Makes an attention interruption pending. 

REQuest 
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REROUTE 



I RESTORE WINDOW CMS 

| Returns a maximized or minimized window to its size and location prior to the maximize or 
I minimize. 

1 REStore WINdow fwnamel 

i l - J 
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REWIND 


REWIND CP Class G 

Rewinds a real tape drive. 

REWind vaddr 


REXX 


CMS 


The Restructured Extended Executor language (REXX) is a command programming language that 
allows you to combine useful sequences of commands to create new commands. The System 
Product Interpreter processes programs written in REXX. REXX is especially suitable for writing 
EXECs or editor macros, but is also a useful tool for algorithm development. 

REXX INSTRUCTIONS 

The formats of the REXX instructions, followed by their descriptions, are: 


ADDRESS fenvironment [expression]1 ; 

[[VALUE] expression J 

Effects a temporary or permanent change to the destination of command(s). 

ARG [template]; 

Retrieves the argument strings provided to a program or internal routine and assigns them to 
variables. It is just a short form of the instruction PARSE UPPER ARG [template];. 

CALL name [expression][,[expression]]... ; 

invokes an internal routine, an external routine or program, or a built-in function. The 
invoked routine may optionally return a result upon its completion. 
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REXX 


REXX (continued) CMS 


DO 

' name=expri [TO exprt] [BY exprb] [FOR exprf]' 


WHILE exprw 


'forever 


UNTIL expru 


exprr 



instruction 

m 

ii 

ii 

END [symbol]; 

Or, to present the instruction more generally: 


DO [repetitor] [conditional]; 
instruction * 

it 

it 

n 

END [symbol]; 

Groups instructions together and optionally executes them repetitively. 

DROP name [name] [name]...; 

"Unassigns” variables; that is, restores them to their original uninitialized state. 

EXIT [expression]; 

Unconditionally leaves a program, and optionally returns a data string to the caller. The 
program is terminated immediately. 
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REXX 


REXX (continued) 


CMS 


IF expression [;] THEN[;] instruction 

[ELSE[;] instruction] 

Conditionally executes an instruction or group of instructions. 

INTERPRET expression; 

Executes instructions that have been buiit dynamically by evaluating an expression (rather 
than that exist permanently in the program). 

ITERATE [name]; 

Alters the flow within a repetitive DO loop (that is, any DO construct other than that with a 
plain DO). 

LEAVE [name]; 

Causes immediate exit from one or more repetitive DO loops (that is, any DO construct other 
than that with a plain DO). 


NOP; 

NOP is a dummy instruction that has no effect. It can be useful as the target of a THEN or 
ELSE clause. 


NUMERIC 


"DIGITS [expression] 

FORM [ SCIENTIFIC 
ENGINEERING 


l^FUZZ [expression] J 

Changes the way in which arithmetic operations are carried out. 

NUMERIC DIGITS controls the precision to which arithmetic operations will be carried out. 
NUMERIC FORM sets the form of exponential notation to be used. 

NUMERIC FUZZ controls how many digits, at full precision, will be ignored during a 
comparison operation. 


OPTIONS [expression] 

Specifies whether double byte character set (DBCS) strings can be manipulated. 


OPTIONS ETMODE 
OPTIONS NOETMODE 


DBCS strings 
DBCS strings 


can be manipulated 
cannot be manipulated 
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REXX 


REXX (continued) 


CMS 


PARSE [UPPER] 


ARG 

EXTERNAL 
NUMERIC 
- PULL 
SOURCE 

VALUE [expression] WITH 
VAR name 


[template]; 


Assigns data (from various sources) to one or more variables according to the rules of 
parsing. 


PROCEDURE [EXPOSE name [name] [name]...]; 

Used within an internal routine (subroutine or function) to protect all the existing variables by 
making them unknown to following instructions. 

PULL [template]; 

Reads a string from the program stack (system-provided data queue). It is just a short form 
of the instruction: PARSE UPPER PULL [template]; 

PUSH [expression]; 

The string resulting from expression will be stacked LIFO ~ onto the most recently created 
buffer of the program stack (system-provided data queue), limited to 255 characters per 
entry. If no expression is specified, a null string is stacked. 

QUEUE [expression]; 

The string resulting from expression will be appended to the most recently created buffer of 
the program stack (system-provided data queue) limited to 255 characters per entry. That is, 
it will be stacked FIFO. If no expression is specified, a null string is stacked. 

RETURN [expression]; 

Returns control (and possibly a result from a REXX program or internal routine to the point of 
its invocation. 

SAY [expression]? 

The result of evaluating the expression is displayed (or typed, etc.) on the user's console. 
The result of the expression may be of any length. 
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REXX 


REXX (continued) 

SELECT; 


WHEN 

expression 

[?] 

THEN 

[;] 

WHEN 

expression 

[?] 

THEN 

[;] 


II II II 

II It II 

II II II 


instruction 

instruction 


it 


OTHERWISE [;] 


instruction 


CMS 


END; 

Conditionally executes one of several alternative instructions. 


SIGNAL 


labelname 

[VALUE] expression 


ON 

OFF 


ERROR * 
HALT 
NOVALUE' 
SYNTAX , 


Causes an abnormal change in the flow of control, or (if ON or OFF is specified) controls the 
trapping of exceptions. 


188 VM/SP Quick Reference 



REXX 


REXX (continued) 


TRACE 


_ 




? 



All 





Commands 





Errors 





Intermediates 



f ? - 1 


Labels 



[1>-J 


Normal Negative 





Off 



Results 



Scan 


[number] 

■i 

- 


Or, alternatively: 


CMS 


TRACE 


string 


[VALUE] expression 
[symbol j 

Primarily used for debugging. It controls the tracing action taken (that is, how much will be 
displayed to the user) during execution of a REXX program. 


UPPER variable [variable] [variable]...? 

Used to translate the contents of one or more variables to uppercase. The variables are 
translated in sequence from left to right. 
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REXX 


REXX (continued) CMS 

REXX BUILT-IN FUNCTIONS 

REXX has many built-in functions and also various functions that are supplied externally. 

The formats of the built-in functions, followed by their descriptions, are: 

ABBREV(information,info[,length]) 

Tests whether info is a true abbreviation of information , with minimum length. 

ABS(number) 

Returns the absolute value of number. 

ADDRESS() 

Returns the current environment for commands. 

ARG([n[,option]]) 

Returns the number of arguments, the nth argument, or test if the nth argument exists or is 
omitted. 

BITAND(stringl[,[string2][,pad]]) 

Returns a string composed of the two input strings logically AND'ed together, bit by bit. 

BITOR(stringl[,[string2][,pad]]) 

Returns a string composed of the two input strings logically OR'ed together bit by bit. 

BITXOR(stringl[,[string2][,pad]]) 

Returns a string composed of the two input strings logically exclusive OR'ed together, bit by 
bit. 

CENTER(string,lengthf,pad]) 

CENTRE(string,length[,pad]) 

Returns a string of length length with string centered in it, with pad characters added as 
necessary to make up length. 

COMPARE(stringl,string2[,pad]) 

Returns 0 if the strings are identical. If they are not, the returned number is non-zero and is 
the position of the first character that does not match. 

COPIES(string,n) 

Returns n concatenated copies of string. 
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REXX 


REXX (continued) CMS 

C2D(string[,n]) 

Character to Decimal. Returns the decimal value of the binary representation of string. 

C2X(string) 

Character to Hexadecimal. Converts a character string to its hexadecimal representation 
(unpacks). 

DATATYPE(string[,type]) 

If only string is specified, the returned result is NUM if string is a valid REXX number (any 
format), or CHAR otherwise. If type is specified, returns 1, string matches the type, otherwise 
0 . 

DATE([option]) 

Returns the local date in the format: dd Mmm yyyy or in the format according to option. 
DELSTR(string,n[,length]) 

Deletes the substring of string that begins at the nth character, and is of length length. 
DELWORD(string,n[,length]) 

Deletes the substring of string that starts at the nth word, and is of length length 
blank-delimited words. 

D2C (whole-number [ ,n] ) 

Decimal to Character. Returns a character string of length as needed, or of length n, which is 
the binary representation of the decimal number. 

D2X(whole-number[,n]) 

Decimal to Hexadecimal. Returns a string of hexadecimal characters of length as needed or 
of length n, which is the hexadecimal (unpacked) representation of the decimal number. 

ERRORTEXT(n) 

Returns the error message associated with error number n. 

EXTERNALS() 

Returns the number of lines in the terminal input buffer (system external event queue). 

FIND(string,phrase) 

Searches string for the first occurrence of the sequence of blank-delimited words phrase, and 
returns the word number of the first word of phrase In string. 

FORMAT(number[,[before][,[after]]]) 

Rounds and formats number to specified integer (before) and (after) decimal places. 
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REXX 


REXX (continued) CMS 

INDEX(haystack,needle[,start]) 

Returns the character position of one string, needle, in another, haystack, beginning at start. 

INSERT(new,target[,[n][,[length][,pad]]]) 

Inserts the string new, padded to length length, into the string target after the nth character. 

JUSTIFY(string,length[,pad]) 

Formats blank-delimited words in string, by adding pad characters between words to justify 
to both margins. 

LASTPOS(needle/haystack[,start]) 

Returns the position of the last occurrence of one string, needle, in another, haystack, 
beginning at start. 

LEFT(string,length[,pad]) 

Returns a string of length length containing the left-most length characters of string. 

LENGTH(string) 

Returns the length of string. 

LINESIZE() 

Returns the current terminal line width (the point at which the interpreter will break lines 
displayed using the SAY instruction). 

MAX(number[,number]...) 

Returns the largest number out of the list specified. 

MIN(number[,number]...) 

Returns the smallest number out of the list specified. 

OVERLAY(new,target[,[n][,[length][,pad]]]) 

Overlays the string new, padded or truncated to length length, onto the string target starting 
at the nth character. 

POS(needle,haystack[,start]) 

Returns the position of one string, needle, in another, haystack, beginning at start. 

QUEUED() 

Returns the number of lines in the program stack (system-provided data queue). 

RANDOM([min][,[max][,seed]]) 

Returns a pseudo-random non-negative whole number in the range of 0-999 or min to max 
inclusive. The generator seed may be specified. 

REVERSE(string) 

Returns string, swapped end for end. 
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REXX 


REXX (continued) CMS 

RIGHT(string,length[,pad]) 

Returns a string of length length right justified. 

SIGN(number) 

Number is rounded and returns the sign of number (-1, 0, or 1). 

SOURCELINE([n]) 

Returns the line number of the final line in the source file or the nth line. 

SPACE(string[,[n][,pad]]) 

Formats the blank-delimited words in string with n pad characters between each word. If it is 
0, all blanks are removed. 

STRIP(string[,[option][,char]]) 

Removes Leading, Trailing, or Both leading and trailing characters from string when the first 
character of option is L, T, or B respectively. The default is B. 

SUBSTR(string,n[,[length][,pad]]) 

Returns the substring of string that begins at the nth character, and is of length length. 

SUBWORD(string,n[,length]) 

Returns the substring of string that starts at the nth word, and is of length length 
blank-delimited words. 

SYMBOL(name) 

If name is not a valid REXX symbol, BAD is returned. If it is the name of a variable, VAR is 
returned. Otherwise LIT is returned. 

TIME([option]) 

Returns the local time in the 24-hour clock format: hh:mm:ss (hours, minutes, and seconds). 
All calls in one expression are synchronized. 

TRACE([option]) 

Returns current trace setting, and sets new trace option. 

TRANSLATE(string[,[tableo][,[tablei][,pad]]]) 

Translates characters in string to be other characters, or may be used to reorder characters 
in a string. If neither translate table is given, string is simply translated to uppercase. 

TRUNC(number[,n]) 

Returns the integer part of the number, and n decimal places. The default n is zero. 

USERID() 

Returns the system-defined User Identifier. 

VALUE(name) 

Returns the value of the symbol name. 
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REXX 


REXX (continued) CMS 

VERIFY(string,reference[,['Match'][,start]]) 

Verifies that the string is composed only of characters from reference, by returning the 
position of the first character in string that is not also in reference If all the characters were 
found in reference, 0 is returned. 

WORD(string,n) 

Returns the nth blank-delimited word in string. 

WORDINDEX(string,n) 

Returns the position of the nth blank-delimited word in string. 

WORDLENGTH(string,n) 

Returns the length of the nth blank-delimited word in string 
WORDS(string) 

Returns the number of blank-delimited words in string. 

XRANGE([start][,end]) 

Returns a string of all one-byte codes between and including the values start and end. 

X2C(hex-string) 

Converts hex-string (a string of hexadecimal characters) to Character (packs). 
X2D(hex-string[,n]) 

Converts hex-string (a string of hexadecimal characters) to decimal. 
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REXX 


REXX (continued) CMS 

RXSYSFN PACKAGE OF CP/CMS FUNCTIONS 

These all provide useful CP or CMS functions. The package is loaded automatically when needed. 
The formats are followed by their descriptions. 

CMSFLAG(flag) 

Returns the setting of one of the specified CMS flags: 

ABBREV AUTOREAD CMSTYPE DOS EXECTRAC 

IMPCP IMPEX PROTECT RELPAGE SUBSET 

DIAG(n[?] [,data][,data]•..) 

Communicates with CP via a dummy DIAGNOSE instruction and returns data as a character 
string. 

DIAGRC(n[?] [,data][,data...]) 

Is identical to the DIAG function, except that CP return code and condition code are prefixed 
to the result. 

STORAGE([address[,[length][,data]]]) 

Returns the current virtual machine size if no arguments are specified; else returns length 
bytes from user's memory starting at address... 


RO CMS Immediate Command 

Resumes recording of trace information previously suspended by the SO Immediate command. 

RO 


ROUTE CMS 

Directs data of a particular message class to a virtual screen. 

ROUTE msgclass TO vname [(options...[)]] 

OPTIONS: 


T ALARM 1 

T NOTify 1 

[NOALARM 1 

1 NONotifv 1 
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ROUTE 


ROUTE RSCS 

Temporarily adds, deletes, or alters an RSCS routing table entry. (For RSCS operator only) 

ROUte nodeid (OFF|TO linkid} 


RSERV CMS 

In CMS/DOS, copies, displays, prints, or punches a DOS/VS relocatable module from a private or 
system library. 

RSERV modname [ftI TEXT ] [(options...()]] 
options: 

[ DISK ] [PUNCH] [PRINT] [TERM] 


RT CMS Immediate Command 

Resumes terminal displaying. 

RT 


RUN CMS 

Initiates a series of functions for a file depending on the file type. Selects or combines the 
procedures to compile, load, or start execution of the specified file. 

RUN fn [ft [fm]] [(args...[)]] 
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RUNTSAF 


| RUNTSAF TSAF 

| Starts the TSAF virtual machine. Only the TSAF virtual console or the secondary user of the TSAF 
j virtual machine can issue this command. 

| RUNTSAF rnnnl [eTRACe] 


S CMS Border Command 

Changes the size of the window. 

s 


SAVENCP CMS 

Reads/Loads 3705 control program load module. 

Note: CP command privilege class A, B, or C is required to use SAVENCP. 

SAVENCP fn [(options...[)]] 

| options: 

| fENTRY symbol! FNAME ncpname! fLIBE libnamel T CAMOD Jot! 

| [ CXFINIT | [fn J [fn ] [ \ljJ 


SAVESYS CP Class E 

Creates a copy of virtual machine storage, registers, and PSW. 

SAVESYS systemname 
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SCREEN 


SCREEN CP Class G 

Alters or changes any color and/or extended highlighting for the virtual machine display area, as 
well as the color in the input area and the status area. 


SCREen 


area Iff extcolo: 

| I ^ DEFault 


extcolorl fexthilight 


\ 1 


NONe 



Note: Each time you enter the command, you must specify at least one screen "area” 
with at least one “extcolor” and/or "exthilight" value. You may specify more than one 
operand on the same command line. 


operand 

‘area’ 
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SCROLL 


SCROLL 

Moves a window to a new location on the virtual screen to which it is connected. 


CMS 


SCROLL 


BAckward I wnarae 


Bottom 


Down 


Forward fwname 


Left 


[ wname r n 1 1 

= l;JI 

| wname | 

[ wname r n 1 1 

; l;ll 
l;]] 

[i]] 


Next 


Right 


Top 


| wname 
wname 

| wname 
^ wname j 


Up 


ill 


SEND CP Class G 

Passes commands and message replies to the designated disconnected virtual machines for 
execution. 

SEND [CP] J userid 1 [text] 
l lprt J 
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SENDFILE 


SENOFILE 


CMS 


Send files or notes to one or more computer users, attached locally or remotely, by issuing the 
command or by using a menu (display terminal only). 


SENDFile [fn ft[fm][[TO] name 


] [options...[)]]) 


options: 

fAck 1 fFilelist 1 (Log 1 TnEwI [" Type 1 [NOTE] 
[ NOAck J [NOFilelist j [NOLogJ [old] [NOTypeJ 


SENTRIES CMS 

Determines the number of lines currently in the program stack. 

SENTRIES 


SET CMS 

Controls various functions within your virtual machine. (Only one function may be specified per 
SET command. 

The options available with SET are listed below. A complete description of each option follows. 


ABBREV 

DOSPART 

APL 

EXECTRAC 

AUTOREAD 

FULLREAD 

BLIP 

FULLSCREEN 

BORDER 

IMESCAPE 

CHARMODE 

IMPCP 

CMSPF 

IMPEX 

CMSTYPE 

INPUT 

DOS 

INSTSEG 

DOSLNCNT 

LANGUAGE 


LDRTBLS 

RELPAGE 

LINEND 

REMOTE 

LOCATION 

RESERVED 

LOGFILE 

SYSNAME 

NONDISP 

TEXT 

NONSHARE 

TRANSLATE 

OUTPUT 

UPSI 

PROTECT 

VSCREEN 

RDYMSG 

WINDOW 

REDTYPE 

WMPF 
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SET ABBREV 



I SET BLIP CMS 

i Turns ON or OFF the BLIP character string displayed at the terminal to indicate every two seconds 
| of virtual interval timer time. 

I I ON l 

I lOFF J 
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SET BORDER 


| SET BORDER CMS 

| Defines borders around windows. 

| SET BORDER wname fON \ {(optionA optionB[)]] 

| lOFFj 

| optionA: [TOP char] [BOTTOM char] [LEFT char] [RIGHT char] [ALL char] 

| optionB: J*High 1 
| LNOHighJ 


[color] 
[exthi] 
[PSset] 


| SET CHARMODE CMS 

| Specifies whether character attributes should be used when displaying virtual screen data on the 
| physical screen. 

| SET CHARMODE /ON \ 

I IOFFJ 


| SET CMSPF CMS 

| Defines a command that should be executed when a specified PF key is pressed in CMS full-screen 
j mode. 

| SET CMSPF nn [/pseudonym! /keyword 1 string! 

j Mnowrite j [ delayed J I 
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SET CMSTYPE 


| SET CMSTYPE 

| Specifies suppression of a CMS terminal display within an EXEC. 


| SET CMSTYPE JhtI 

I iRTf 


CMS 


| SET DOS CMS 

! Indicates whether your CMS virtual machine is in CMS/DOS environment, specifies the mode letter 
| at which the VSE system residence is accessed, and specifies that you are going to use the 
| AMSERV command or you are going to execute programs to access VSAM data sets. 

| SET DOS foN [mode[ (VSAM[)]]]! 

I lOFF J 


| SET DOSLNCNT CMS 

| Specifies the number of SYSLST lines per page. 

| SET DOSLNCNT nn 


| SET DOSPART CMS 

| Specifies control regarding the size of the virtual partition in which you want a program to execute. 


| SET DOSPART fnnnnnKl 
I lOFF J 


| SET EXECTRAC CMS 

| Specifies whether you want tracing turned on or off for your System Product Interpreter or EXEC2 
I program. 

| SET EXECTRACfON \ 

I IOFFJ 
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SET FULLREAD 






SET IMPEX 


| SET IMPEX CMS 

| Controls whether EXEC files are treated as commands. 

| SET IMPEX f ON 1 

| \offJ 


| SET INPUT CMS 

| Controls the translation of a specified character “a M to hexadecimal code xx for characters entered 
j from the terminal and the reset of the hexadecimal code xx to the specified hexadecimal code yy in 
j your translate table. 

| SET INPUT T a xx 1 
I Ixx yy J 


| SET INSTSEG CMS 

| Specifies whether the system should search the installation Discontiguous Shared Segment (DCSS) 
i to locate an EXEC or Editor Macro. 

| SET INSTSEGfoN [mode|LAST] 1 
I l OFF J 


| SET LANGUAGE CMS 

| Changes the current language of your CMS session and any application running on CMS that uses 
| national language support. 

| SET LANGuage [langid] [(options...[)]] 

] options: 

| *ADD applid 1 f USER I pTYPE 

j DELETE applid I SYSTEM NOTYPE 

I l J L all J t 
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SET LDRTBLS 


| SET LDRTBLS CMS 

| Defines the number (nn) of pages of storage to be used for loader tables. 

| SET LDRTBLS [nn] 


| SET LINEND 

| Activates and/or defines the logical line end for full-screen CMS. 


SET LINEND 


i 0N l 

t OFFJ 


[char] 


CMS 


| SET LOCATION CMS 

| Specifies whether the location indicator should be displayed in the window when the data in the 
| virtual screen exceeds the size of the window. 

| SET LOCATION wname fON \ 

I IOFFJ 


| SET LOGFILE CMS 

| Indicates whether a log file should be updated with the data being written to the virtual screen. 

| SET LOGFILE vn 


I 


r° N i 

l OFF J 


f n 

’logfile ffmll 


I AiJ J 


| SET NONDISP CMS 

| Defines a character to be used in place of nondisplayable characters. 

| SET NONDISP [char] 
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SET NONSHARE 


| SET NONSHARE 


| Specifies a non-shared copy of a normally shared named system. 


| SET NONSHARE 


'CMSDOS 

CMSVSAM 

CMSAMS 

CMSBAM 


CMS 


| SET OUTPUT CMS 

| Controls the translation and reset of the specified hexadecimal representation xx to the specified 
| character "a” for all xx characters displayed at the terminal. 

| SET OUTPUT [xx a] 


| SET PROTECT 


| Specifies whether the CMS nucleus is protected against writing in its storage area. 


| SET PROTECT (ON \ 
I lOFFj 


CMS 


| SET RDYMSG CMS 

| Indicates whether the standard CMS ready message or a shortened form of the CMS ready 
| message is used. 


| SET RDYMSG 


'lmsg! 

[SMSG J 
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SET REDTYPE 


| SET REDTYPE CMS 

| Controls whether CMS error messages are typed in red for certain terminals equipped with the 
j appropriate terminal feature and a two-color ribbon. 

| SET REDTYPE fON 1 
I \OFFj 


| SET RELPAGE CMS 

i Releases or holds the page frames of storage and sets them to binary zeros, after the following 
| commands complete execution: ASSEMBLE, COPYFILE, COMPARE, EDIT, MACLIB, SORT, TXTLIB, 

| UPDATE, HELP, and the program product language processors supported by VM/SP. 

| SET RELPAGE /ON 1 
I lOFFj 


| SET REMOTE 


| Controls the display of data transmissions. 


| SET REMOTE fON 1 
I |OFFJ 


CMS 


| SET RESERVED CMS 

| Specifies whether the number of lines in a window are to be used to display virtual screen reserved 
I lines. 

i SET RESERVED wname ^rtopj. ^rbotj. 
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SET SYSNAME 


SET SYSNAME 



CMS 

Allows for the replacement of a saved system name entry in the SYSNAMES table with the name of 
an alternative, or backup system. 

SET SYSNAME 

P % 

CMSDOS 

CMSVSAM 

CMSAMS 

CMSBAM 

* 4 

entryname 


SET TEXT 




CMS 

Activates character code conversion of TEXT characters for windows. 


SET TEXT fON \ 

\OFFj 




SET TRANSLATE 



CMS 

Suppresses translations and translation synonyms of command names for a language. 

SET TRANSLATE 

i 0N l 

lOFFj 

USER 

SYStem 

ALL 

"TRANslate TaPPLID applidll 
SYNonym [ ^ J f 
BOTH J 



I SET UPSI CMS 

! Controls the setting of the UPSI (User Program Switch Indicator) byte to the specified bit string of 
| 0's and 1's or to binary zeros. 

| SET UPSI f nnnnnnnnl 

I IOFF J 
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SET VSCREEN 


| SET VSCREEN CMS 

| Indicates what action should take place when the virtual screen is updated with data. 


SET VSCREEN 

vname 

T TYPe 1 

rPRotect 1 

T High 1 


4 

[notypej 

[NOPRotectJ 

[ NOHighJ 



[color] 

[exthi] 

[psset] 


| SET WINDOW CMS 

| Specifies whether the window is to be variable or fixed size. 


SET WINDOW 

wnamel FVARiablel 

f POP 1 

(“top 1 


1 [Fixed J 

[NOPopJ 

[NOTopj 


I SET WMPF CMS 

| Defines a WMPF key to execute a windowing command. 


SET WMPF 

nn I Jpseudonyml 

fkeywordl 

string 


[ JNOWRITE J 

[delayed] 
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SET 


SET 


Sets special CP preferred options. 


SET 


AFFInity [userid] [ON[OFF Inn] 
CPAssist {ON|OFF} [PROC[nn]] 

FAVORed userid [hnnl 
[pFFj 

JOurnall fLOgonl f ONl 

jLInk j|c>FfJ 

PRIORity userid nn 

QDROP userid (ON|OFF}[USERS)[NOQ3] 
REServe userid {nnn|OFF} 

SASsist {ON|OFF} [PROC[nn]] 

S370E {ON|OFF} [[PROC]addr] 


CP Class A 


SET 

Establishes disposition for log messages and dumps. 


SET 


DUMP 


LOGmsg 


MITime 


fAUTO \ TCP 1 

\raddrj [allJ 


I nn 
NULL 

class 


[text] 


] 


fmm:ssl f classfmm:ssl. . .1 ^ 

\ OFF J [ | OFF J J 


OFF 


CP Class B 
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SET 


SET 


CP Class E 


Sets SRM function and the number to be used in the working set size estimate control algorithm. 


SET 


PAGing nn 


SRM 


f APAGES nnnn 


DSPSlice nnn 
IB n 

MAXDrum (nnnn|OFF} 
MAXWss {nnnn|OFF} 
MHFULL {nnn|OFF} 

PB nn 

PCI {DRUM|DISK} 
PGMTlim 


SET CP Class F 

Sets recording mode for a device, or enables/disables soft machine check interrupts. 


SET RECord (OFF 

j ON raddr LIMIT nn BYTE nn BIT 


n ^|AND^ BYTE nn BIT nj| 


MODE 


^RETRY^ ^Quiet ^ [cpuid] 


(MAIN n RecordJ 
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SET 


SET 

The SET command controls various functions within your virtual machine. 


Set 


ACNT 

AUTOPol1 

RUN /ON \ 

LINEDit lOFFj 

NOTRans 

ECmode 

CONCeal 

ISAM 

PAGEX 

EMSG {ON|OFF|CODE|TEXT|IUCV} 
TIMER {ON|OFF|REAL} 

CPUid bbbbbb 


IMSG (ON I 
MSG -I OFF V 
SMsg [iUCVj 
WNG 


CPCONIO (OFF \ 

VMCONIO IIUCVJ 

ASsist /(ON] fSVCINOSVC][TMRI NOTMR ] 
IOFF 


} 


AFFInity [ON|OFF] 

PFnn flMMed 1 (pfdatal#pfdata2#...pfdatan] 

I pELaved J 


PFnn (TAB nl n2...] 


PFnn 


COPY 

COPY 

COPY 

COPY 


(resid) 
(cuu) 

(luname) 
(Laddr) 


PFnn RETrieve 


VMSAVE1 {ON|OFF|name} 
STBypass 


JnoverifyJ| 


[ nnnnnK |NOVERIFY| 
nnM 


VR 

IOFF 


CP Class G 
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SET 



I SET ETRACE TSAF 

| Enables or disables external tracing. Only TSAF virtual console or the secondary user of the TSAF 
| virtual machine can issue this command. 

| SET ETRACE [ ON ] 

I l OFF J 
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SETKEY 



SHUTDOWN CP Class A 

Checkpoints and terminates the current VM/370 operation. 

SHUTDOWN T REIPL[raddr] 1 
POWEROFF 
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SHUTDOWN 


SHUTDOWN RSCS 

Stops RSCS operations in an orderly fashion. Issues DRAIN to all active links, unless faster 
termination is requested by the QUICK command. Deactivates the RSCS/VTAM interface (if it is 
active). (For RSCS operator only) 

SHUTDOWN [QUICK] 


SIZE WINDOW 

Changes the number of lines and columns for a specified window. 

SIZE WINdow fwnamel lines [cols] 


1 • I 


CMS 


SLEEP CP Class Any 

Places the virtual machine in a dormant state with the terminal keyboard entry blocked. Allows 
message display. 



SMSG CP Class G 

Sends a “special message" to a virtual machine which is running with SET SMSG ON. 

SMsg userid msgtext 
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SMSG 


SMSG 


RSCS 


Delivers the command text to the RSCS virtual machine to be executed. All RSCS commands that 
are issued by a virtual machine user (including authorized alternative operators) must be included 
as text in an SMSG command. (The exception is when a local installation has provided an EXEC for 
each command that automatically puts the "SMSG rscsid" characters in front of the RSCS 
command expression). 


SMsg rscsid 


command-text 

* Msg nodeidm userid message-text ► 
CMD nodeidc CMD-command-text 


| SNTMAP CMS 

| Processes DMKSNT macro definitions and produces two CMS files; a saved segment DASD map 
| and a virtual memory map. 

| SNTMAP (fn (ft (fm))) 


SO CMS Immediate Command 

Suspends the recording of trace information during the execution command or program. 

so 


SORT CMS 

Sorts records within a file and creates a new file containing the sorted records. 

SORT fileidl fileid2 
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SPACE 


SPACE 


CP Class D 


Forces single spacing on the printer. 


efraddrl 

Wt J 


SPGEN 


CMS 


Does various system generation and maintenance functions, using the parameters contained in 
SPGEN PROFILE. These functions include: 

• Creating, verifying, and displaying system profile parameters. 

• Assembling system files. 

• Generating CP, CMS, and GCS nuclei. 

• Receiving and verifying load maps. 

SPGEN f CREATE [ (opt ionA [ ) ] ] "I 


optionA: 


optionB: 


optionC: 


ASSEMBLE fn 


[ ALL 1 

compid J 

[ comp id 1 

CP J 


DTYPE vdev 


[PROFILE profname] 


[NOIPL] 


! (optionA[)]] 
; (optionA[)]] 


' (optionA[)j 


comp id [(optionA[)]] 


compid [(optionA optionB optionC[)j 

compid [(optionA[)]] 
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SPLOAD 


| SPLOAD CMS 

| Loads contents of the VM/SP product tapes to appropriate minidisks during initial VM/SP 
| installation. 

| SPLOAD group element ffn fftll 

I l* l* ij 


SPMODE CP Class A 

Establishes or resets the single processor mode. 

SPMode f ON I 
l OFFJ 
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SPOOL 


SPOOL 


CP Class G 


Changes spooling control options. 


Spool J Readert 
l vaddr J 


* 

Printer 

PUnch 

CONsole 

l^vaddr 


[ CLass f * 1 1 fcONt 1 TeOF 1 f HOLD 1 
\cjl LNOContJ LNOEofJ [ 


[ To 1 fuser id 
For * 

SYSTEM^ 


NOContJ LNOEofJ iNOHoldJ 
1 

| fCONt 

[NOHold 


OFF 

close] 

purge] 


f HOld 1 rCONt 1 
1J ^NOContJ 


[CLass c][COpy[*]nnn] 


FLash name nnn 
Modify name[n] 
Chars namel 
[name2] 

[name3] 
[name4]]] 
CHars namel 
[CHars name2 
[CHars name3 
[CHars 

name4]]] 
FCB name 


I FORM [form 
[OFF 


2 

IDist fdistcodel | |STArt]f 
[ (OFF j] ISTop Jl 


TErm 

NOTErm 


DESTfdest 

(OFF 


}] 


At least one of the options within braces must be selected; however, more than one may be 
specified, and they may be entered in any order on the command line. 


2 These options apply only to a virtual spooled console. 

3 These options can only be used to modify a virtual spooling printer. These options only apply to 
a device type 3800 as a virtual spooling device. 
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SPTAPE 


SPTAPE 

Dumps output spool files to tape or loads output spool files from tape. 


SPTape 


STOP raddr 

CANCEL raddr 

SCAN raddr option2 

LOAD raddr SADump option2 


LOAD raddr 


Printer 

PUnch 

Reader 


spoolidl fspoolid2| 

Lend 


J 


DUMP raddr 


Printer 

PUnch 

Reader 


CLass cl (c2[c3[c4]]][FORM form][DEST dest] 
FORM form [DEST dest] 

DEST dest 
ALL 

spoolidl spoolid2 
END 

CLass cl[c2[c3[4]]][FORM form][DEST dest] 
FORM form [DEST dest] 

DEST dest 
ALL 


options: 


option3 




f * 




optionl 

MODE 

800 


option2 

LEAVE 


1600 

► 

REWind 



6250 



RUN 



38K , 





SYSHOLD 

USERHOLD 

NOHOLD 


option4 [PURGE] 


CP Class D 


option2 
option3 


option1 
option2 
option3 
- option4 
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SSERV 


SSERV CMS 

In CMS/DOS, copies, displays, prints, or punches a book from a DOS/VSE source statement library. 

SSERV sublib booknamefft 1 [(options...[)]] 

[cOPYj 


options: 

[ DISK ] [PRINT] [PUNCH] [TERM] 


START 


CP Class D 


Restarts a drained device or changes its output spooling class. 


STArt 


ALL 


Printer 

PUnch 

Reader 


raddr[CLass c...] 

FORM form* 

DEST dest 

[NOsep] 

AUto 

N03800 

lprt 

FORM * 

DEST OFF 


SETup 

BEG3800 



DEST * 


MAnual^ 

ANY3800 


FLash name 
CHars name 
FCB plpi 
IMage imagelib 
PUrge 


DEFfcb 

FILefcb 

CFIlefcb^ 


START 


Begins program execution. 


START 


entry [args...] 


(option!) 1 
option: [NO] 


CMS 
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START 


START RSCS 

Activates a specified communication link. 


STArt [linkid] 


[CLass c ] 

[DP dpriority ] 

[FOrm name ] 


[LINE vaddr ] 

[LOGMode logmodename ] 

[LUName luname ] 

[ MANUAL IAUtOI SETUP ] 

[Queue ( Priority IFifolSize} 


[TRace 

TYPE 


(ALL|LOG) ] 
NJE 

SNANJE 

RJE 

MRJE 

3270P 

SNA3270P 


] 


[OParm operation parameters... 
iParm [operation parameters ...] 


Note: Any combination of keywords with associated options may be entered in any order, except 
that Parm keyword must be the rightmost keyword. 
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STAT 


STAT 

Lists current status of a problem, a specific subset of problems, or all problems. 

STAT L nnnnn 
ALL 


IPCS 


HELP 


fOPENUSERt 

1 

ABend 

(OPNUSR J 


JdocI 

f OPENIBM\ 


Idd J 

lOPNIBM J 


INcorr 

JopenI 



lOPN J 


INF 

APARED 


f loop! 



ILP J 

JneedinfoI 
Indinfo J 


MSg 

fPTFRCVDl 


JperformI 

Iptfrcv J 


IPR J 

PTFON 


WAIT 



WS 



JptferrorI 

\?E J 

CLOSED 







1 One of these status keywords may be specified with the ALL operand. 

2 One of thes$ failure keywords may be specified with the ALL operand. 


STATE/STATEW CMS 

STATE verifies the existence of a file on any accessed disk. STATEW verifies the existence of a file 
on a read/write disk. 


STATE 

STATEW 


til 
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STCP 


STCP CP Class C 

Alters contents of real storage. The real PSW or registers cannot be altered. Shared pages In a 
system running in AP mode cannot be altered. 





STCP 


hexloc 

Mhexloc 

Nhexloc 

hexwordl [hexword2...] 



Lhexloc 

MLhexloc 




NLhexloc 



! 

Shexloc 



j 

MShexloc 

•hexdata 



NShexloc 

V J 





- 


STOP RSCS 

Quickly deactivates a specified link without completing transmission of a file. 

STOP [linkid] 


I STOP TSAF TSAF 

| Stops the TSAF virtual machine. Only the TSAF virtual console or the secondary user of the TSAF 
j virtual machine can issue this command. 

| STOP TSAF 
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STORE 


STORE 

Alters virtual machine storage, PSW, and registers. 

STore | hexloc hexwordl[hexword2...] 
Lhexloc 

Shexloc hexdata 

fGregl hexwordl[hexword2...] 

IXregJ 

{Yreg} hexdwordl[hexdword2...3 
Psw [hexwordl] hexword2 
STATUS 


CP Class G 


SVCTRACE 

Records information about supervisor call instructions. 

SVCTrace f ON 1 
I OFF J 


SYNONYM 

Specifies alternate names for invoking CMS commands. 


SYNonym 

' f n 

SYNONYM 

fm* 

■ 





A1 






* 

m 

, 


options: 


STD [CLEAR] 
NOSTD 


CMS 


CMS 
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SYSTEM 


SYSTEM 


CP Class G 


Simulates virtual machine console functions and clears virtual storage and storage keys to binary 


CP Class G 


Appends or queries the TAG text to a VM/SP spool file utilized by subsystems (such as RSCS). 


TAg DEv Printer* [tagtext] 
PUnch 
CONsole 
,vaddr 


File spoolid [tagtext] 


t PUnch 
CONSole 
vaddr , 


File spoolid 
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TAPE 


TAPE 


Performs tape to disk or disk to tape operations for CMS files. 


TAPE 


DUMP 


LOAD 


SCAN 


SKIP 


[WHri] 

[mi 

[WB' 


[(optionA optionB optionD 
optionF[)]] 

[(optionB optionC optionDl)]] 

[(optionB optionC optionD[)]] 

[(optionB optionC optionD[)]] 


DV0L1 [(optionD optionE[)]] 

WV0L1 volid [owner] [(optionD optionE[}]] 
MODESET [(optionD[)]] 
tapcmd [nl^l] [ (opt ionD[) ] ] 

Note: The tapcmd operand can be one of the following: 

[BSF|BSR|ERG|FSF|FSR|REW|RUN|WTM] 


optionA: optionB: optionC: 


fWTM ] r BLKSIZE 4096] 

*N0PRint 


EOF n' 

InowtmJ [blksize 800J 

PRint 


EOT 


DISK 


EOF 1 


Term 




* • 



optionD: 


fTAPn] fcuu] 

[TRTCH a] 

*7TRACK * 

[TAPlJ [l8l] 


9TRACK 

* 


( 18TRACK 


CMS 


228 VM/SP Quick Reference 




TAPE 


TAPE (continued) 


CMS 


optionE: 

optionF: 


fLEAVE 1 

f TRANsf er 

BUFFered 1 

[rewind] 

[TRANsfer 

IMMEDiateJ 


TAPEMAC CMS 

Creates a CMS MACLIB from an unloaded partitioned data set (PDS) from a tape created by the 
IEHMOVE utility program under OS. 

TAPEMAC fn f SL [labeldefid] 1 [(opt ions...[)]] 

[ NSL filename [ID=identifier]J 


options: 


T TAPnl 

[“ ITEMCT 

yyyyy] 

[tapi] 

[ITEMCT 

50000 ] 


TAPPDS 


CMS 


Creates CMS disk files from tapes which are input to or output from the IEBPTPCH, IEBUPDTE, and 
IEHMOVE OS utility programs. 


TAPPDS 

fn 

'ft 

fm 



f SL [labeldefid] 1 


* 

± 

* 



[NSL filename [ID=identifier] j 




A1 







~ - j 


[ (options...[)]] 


options: 


PDS TcOLI 1 r TAPn1 TEND 

NOPDS NOCOLl I TAPI NOEND 
UPDATE^ ** * * J ** 


’ MAXTEN 
NOMAXTEN 
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TE 


TE CMS Immediate Command 

Trace end command stops all tracing of your System Product Interpreter or EXEC 2 program or 
macro. 

TE 


TELL CMS 

Send a message to one or more computer users who are logged on to your computer or to one 
attached to yours via RSCS. 

TELL name message 
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TERMINAL 


TERMINAL 


CP Class G 


Controls virtual console functions. 


TERMinal 


CHardel 
LINEDel 
LINENd 
Escape 
TABchar 2 


f Ff I 

^charI 




HIlight 

SCRNsave 3 

MODE {CP|VM} 

LINESize {nnn|OFF) 

. CONmode {3215(3270} 

BREakin [IMmed|GUESTct1} 

BRKkey {PAl|PF1|...|PF24 NOne} 

TYpe {3101|TTY} 

PROMpt {VM|TTY} 

SCROLL {nnn|CONT} 

ACSiitbl fVM2 \ 

IVMl J 

CNTL fUSRl 
^SYSJ 

1 More than one function can be specified in a single entry of the TERMINAL command. For 
example: 

TERMINAL CHARDEL OFF MASK ON LINESIZE 90. 

2 The TABCHAR operand is available on the 3278 Model 2A console. 

3 The SCRNSAVE operand is not provided for VM/VTAM and remote terminals. 
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TRACE 


TRACE 

Traces and records program execution. 


CP Class G 


[ NORunl 
RUN 


TRace | ( SVC "1 1 | PRINTer 

I/O 

PROgram I I I TERMinal 1 

EXTernal | | |BOTH 

PRIV 

SIO 1* | OFf 

CCW 

BRanch 
INSTruct 
ALL 
CSW 
END 

1 More than one of these activities may be traced by using a single TRACE. For example: 

TRACE SVC PROGRAM SIO PRINTER. 


TRACE 


Monitors line activity on a specified link. 


TRace [linkid ] 


ALL 

LOG 

NOLog 

OFF 


[TO userid [nodeid ] 


RSCS 


TRANSFER CP Class D 


Transfers closed reader spool files. 


TRANsfer 

userid 

PRinter 


spooiid 


[to] r * \ 


Printer 


SYSTEM 

PUnch 


CLass c 


luseridj 


PUnch 


* 

Reader 

- 

FORM form 




Reader 




DEST dest 

■ 






ALL 


FROM /ALL 1 






luseridj 
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TRANSFER 


TRANSFER 

Transfers closed reader spool files. 


Printer 


spoolid 


f [TO] J 

userid ' 



Printer! 

PUnch 


CLass c 


1 

* 



PUnch I 

Reader 

- 

FORM form 


From 

’ ALL 



Reader 1 



DEST dest 


1 

,userid 

r 




ALL 







* • 


* 


- 



TRANSFER 

Changes the destination address for specified files. 

General User Format: 

TRANsfer [*]spoolid TO nodeid [userid] 

Operator Format: 

TRANsfer [linkid] spoolid [spoolid...] TO nodeid [userid] 


CP Class G 


RSCS 
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TRAPRED 


TRAPRED CMS 

Accesses the CPTRAP reader file and reviews the entries contained in that file. Once TRAPRED is 
invoked, you may execute TRAPRED subcommands. 


TRAPRED filenum 
TRAPRED subcommands: 




* 


typenum 

Vmblok 

address 



DEVaddr 

cuu 



COde 

code-value 



MACHtype 

r nn i 




\machnamej 



OFF 



ALL | 

ON 1 

OFFJ 



Hex 




Format 




TOP 




BOTtom 




Up 

PI 

Down 

PI 


UJ 


l n J 

Type 

PI 

TYPEBack 

PI 


u 


l«J 

Printer 

[i] 




QUIT 

Note: The TRAPRED subcommands must be entered on separate command lines. 


TS CMS Immediate Command 

Trace start command starts tracing your System Product Interpreter or EXEC 2 program or macro. 
TS 
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TXTLIB 


TXTLIB 


Updates a library of TEXT files (object modules). 


Txrlib 


GEN libname fnl [fn2...] [(optionA [)]] 

ADD libname fnl [fn2...] [(optionA [)]] 
DEL libname membernamel [membername2...] 
MAP libname [(optionB...[)]] 


| optionA: 
| optionB: 


[FILename] 

TERM 

DISK 

PRINT, 


CMS 


TYPE 

Types or displays all or part of a file at a terminal. 

Type fn ft Jfmj ’reel 
1 


options: 


COL fxxxxxl 

-ryyyyyl 

[HEX] 

memberJ* l] 

n r 

jlreclj 


MEM InameN 


’recri] [ (options ...[)] ] 

. * J 


CMS 


UNLOCK 


Releases pages of storage. 

UNLOCK 


userid'J 
SYSTEM J 


firstpage lastpage 


Jvirt=real1 

V=R J 


CP Class A 
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UPDATE 


UPDATE CMS 

Makes changes in a program source file as defined by control statements in a record file. 


Update fnl ftl 

f fml [fn2 [ft2 [ fm2 ] ] jll 

[ ( options.. 

. [)]] 

ASSEMBLE 

U JJ 




options: 

[ REP 1 fSE08 1 fINC 1 fCTL 1 fSTK 1 [TERM 1 TPRINtIT STOR 1 

norepJ [noseqsJ I noinc J [ noctl J [nostkJ[notermJ [ disk J [nostor J 

[OUTMODE fm] 

Control Statements: 


./ S [seqstrt [seqincr [label]]] 

./ I seqno [$ [seqstrt [seqincr]]] 

./ D seqnol [seqno2] [$] 

./ R seqnol [seqno2] [$ [seqstrt [seqincr]]] 
./ * [comment] 


| UTILITY 


CMS 


I Allows you to do some occasionally used utility functions (i.e. print off system definition files, create 
i a stand-alone service utility tape, and write back-up copy of the CP nucleus to tape. 


UTILITY 

PRSAMPLE 



UTILITAPE 

'ALL' 



DSF 



FMT 



DDR 

< 


.DIR, 


! 


I 


IPLDECK 

’ALL 


DIR [ctlfile] 


DDR 


► FMT 


L NUCTAPE 
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VALIDATE 


| VALIDATE CMS 

| Verifies the syntax of a file identifier (filename filetype filemode). If the filemode is specified, 

| VALIDATE verifies whether or not the disk is accessed. 


| VALIDATE 


{“} [•'] 


VARY 


Varies the availability of a device. 


VARY 


ONLine \ 
OFfline] 


’raddr... 
raddr-raddr 
lprt 

.PROCessr 


OFfline PROCessr nn f VPHY l [FORCE] 
[VLOGJ 


CP Class B 


VMDUMP CP Glass G 

Dumps storage for virtual machine. It enables sending dumps to other users. Used in conjunction 
with VM/IPCS. 


VMDUMP Thexlocl 

L 


f-1 fhexloc2 1 

1 : J Lind J 

{. } fbytecount 
[ END 


‘ to * 

TO userid 
SYSTEM 


[FORMAT vmtype] 


[ DSS] [*dumpid] 
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VMFASM 


I VMFASM CMS 

I Updates a specified source file according to entires in a control file and assembles the updated 
j source file. 

| VMFASM fn ctlfile [(options...)] 

| options: 

[ DISK 1 [TERM 1 [LIST 1 [DECK 1 [RENT 1 EXP XREF 

PRINT ] [ nOTERMJ [nOLISTJ [nODECK J [ NOR ENT j 


max' 

MIN 

STD 


I VMFDOS 


CMS 


Creates CMS files containing VSE modules for specific installation purposes only. VMFDOS uses 
either a VSE distribution library tape or VSE SYSIN tape to install only DOS/VS RPG II and 
VSE/VSAM Program Products. 





p 

VMFDOS [LOAD] 

[18ll 


PRIVate 

[scan] 

[l82j 


SYSTem 

SYSIN 


pTAPll 
[tAP2 J 




[fn] [(options...)] 


PRIV or SYST options: 



[* * 1 

|ZZZ* f 

[module namej 


SYSIN options: 


{ 


ALL 1 
SELECT] 
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VMFLKED 


| VMFLKED CMS 

I Invokes the CMS LKED command to link-edit modules into a loadlib. 

| VMFLKED fn [ft [fm]J [(options [)]] 

| options: 
j PRINT 

| MODULE module-name 


| VMFLOAD CMS 

| Generates a new CP nucleus, or stand-alone dump (DDR) program. The VMFLOAD program uses 
j two files, a loadlist EXEC file and a control file, to produce a punch file that has several object 
| modules. 

| VMFLOAD loadlist ctlfile [langid] 


I VMFMAC CMS 

| Updates Macro libraries. If you specify a control file, the EXEC invokes the CMS UPDATE command 
| to update specified copy or macro files, according to entries in a control file, and then builds a new 
| macro library from the resulting new versions of those files. 

| VMFMAC libname [ctlfile] 


| VMFMERGE CMS 

| Applies PTFs from the DELTA disk to the Merge disk. 

| VMFMERGE prodid fPTF {ptfnum | *}L [EXCLUDE exclist] 

| *\PTFLIST applist J 
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VMFNLS 


I VMFIMLS CMS 

| Automatically applies updates to national language-related source files, generates text files, and 
j renames the text files so they can be loaded into the system. 

| VMFNLS fn ft ctlfile [(options...[)]] 


VMFPLC2 


CMS 


Loads source code from the Product Tape, loads the service installation VMSERV EXEC from the 
Program Update Tape, dump CMS-formatted files from disk to tape, and loads previously dumped 
files from tape to disk. The VMFPLC2 command does not process multi-volume files. Files 
processed by the VMFPLC2 command must be CMS-formatted. 


f} [?] 
[£”} W [Tl] 

[ti {“}] 

{:■} H 


tapcmd 


[ (optionD)] 


[ (optionD) ] 


(optionA optionBl 
L optionD) J 

(optionB optionC 
optionD optionE 
optionF) 


|(optionB optionC optionD] 
[ optionF) J 

[ (optionB optionCl 
optionD) J 


optionA: 


optionB: 


'WTM ' 
NOWTM 


NOPRint 

PRint 

Term 

DISK 

APPend 
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VMFPLC2 


VMFPLC2 (continued) 


optionC: 

[ EOT 1 
EOF nl 
EOF lj 


optionD: 



* 7TRACK* 
9TRACK 
18TRACK^ 


optionE: 


optionF: 


[SELect] [STOP] [DATE] 


[DEN den] 


TRTCH a] 


CMS 


| VMFREMOV 


| Removes PTFs applied by the VMFMERGE EXEC procedure. 


| VMFREMOV prodid 


PTF [ptfnum | *} 
PTFLIST remlist 
^CONVERT [lastfilemode] 


CMS 


| VMFTXT CMS 

| Creates text libraries. VMFTXT rebuilds a named TXTLIB file using a member list in an EXEC file 
| with the same name. 

| VMFTXT libname [ctlfile] 


| VMFZAP CMS 

| Applies ZAPs and maintains a record if them in the ZAP Log. This exec uses the Base disk, Merge 
j disk and the ZAP disk as inputs and produces an updated ZAP disk as output. 

| VMFZAP prodid 
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WAITREAD VSCREEN 


| WAITREAD VSCREEN CMS 

| Updates the virtual screen with data, rebuilds the screen image (updates the 3270 data buffers), and 
| waits for the next attention interrupt. 

| WAITREAD VSCreen vname 


| WAITT VSCREEN CMS 

| Updates the virtual screen with data. 

I WAITT VSCreen \ vname 1 

I l t J 


WARNING CP Class A or B 

Sends high priority messages. 

Warning f userid 
Wng 4 Operator 

[all 


^ msgtext 
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WRITE VSCREEN 


WRITE VSCREEN 


CMS 


Enters information into a virtual screen. 


WRITE VSCreen vname line col length [([REServed] [optionA] [optionB] [optionC] 

[optionD] [)]] 


optionA: 

'blanks! 

NULIs J 


optionB: 

pPROtect 1 

High 1 


[NOPROtectJ 

NOHigh 1 



InvisibleJ 


optionC: [color] [exthi] [psset] 


optionD: 


'field' 

DATA 
COLOR 
EXTHI 
.PSS . 


text 


Note: 

If optionD is used, a right parentheses cannot be used to mark 
the end of the options. 


X CMS Border Command 

Maximizes the window, 
x 
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XEDIT 


XEDIT CMS 

Creates, modifies, and manipulates CMS disk files. This is the command used to invoke the VM/SP 
System Product editor. Once XEDIT is invoked you may execute XEDIT subcommands and use the 
System Product interpreter or the EXEC 2 macro facility. 

Note: In all formats of the XEDIT subcommands and macros, use of the word “subcommand” 
means an XEDIT subcommand only. 

Xedit [fn [ft [fm]]] [(options...!)]] 

options: 

[Width nn] [NOSCreen] [PROFile macroname] [WINdow wname] 

[NOCLear] [NOPROFil] [NOMsg] [MEMber membername] 

options valid only in Update mode: 

[Update|NOUpdate] [ Seq8 1NOSeq8] [Ctl fnl|NOCtl] 

[Merge] [UNtil filetype] 

[Incr nn] [SIDcode string] 

The formats of the XEDIT subcommands and macros, followed by their descriptions, are: 

& [subcommand] 

Redisplays the subcommand and allows reexecution by pressing the ENTER key. 

? 

Displays the last executed XEDIT subcommand except for the = (equal sign) or the ? 
(question mark) subcommands. 

= [subcommand] 

Reexecutes the last subcommand or macro that was entered. Also executes a specified 
subcommand and then reexecutes the last one entered. 

Add [n|1] 

Inserts blank lines immediately following the current line. 

ALL [rtarget] 

Displays a specified collection of lines for editing, while excluding others from the display. 
This is a macro. 
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XEDIT 


XEDIT (continued) 


ALter charl char2 

target 

[ n fPl 



1 

* 




i IIJ 




Lg 



Changes a single character to another character unavailable on terminal keyboard by 
referencing its hexadecimal value. This is a macro. 

BAckward [n|*|l] 

Scrolls backward the number of screen displays specified. 

Bottom 

Makes the last line of the file or of the range (see SET RANGE) the new current line. 
CANCEL 

Terminates the editing session for all of the files. This is a macro. 

CAppend [text] 

Appends specified text to the end of the current line. This is a macro. 

CDelete [ column-target | 3.] 

Deletes one or more characters from the current line, starting at the column pointer. 
CFirst 

Moves the column pointer to the beginning of the zone (see SET ZONE). 


Change /stringl 


/string2/ 


target 


1 



Changes a specified group of characters on one or more lines at one time. 


CMS 
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XEDIT 


XEDIT (continued) CMS 

CInsert text 

Inserts text Into the current line immediately ahead of the column pointer. 

CLAst 

Moves the column pointer to the end of the zone (see SET ZONE). 

CLocate column-target 

Scans the file for a specified column-target starting at the column following (or preceding) the 
column pointer in the current line. Also finds successively all occurrences of a character 
string. 

CMS [commandline] 

Forces the editor to transmit a command to CMS for execution or causes the editor to enter 
CMS subset mode. 

CMSG [text] 

Displays a message in the command line; intended for issurance from a macro. 

COMMAND [commandline] 

Causes the editor to execute a specified XEDIT command without first checking for a 
synonym or macro with the same name. 

COMPress [target|1] 

Prepares one or more lines for automatic repositioning of data (see SET TABS). 

COpy targetl target2 

Copies one or more lines at a specified location in the file. 

COUnt /string [/target| 1 ] 

Displays the number of times a specified character string appears in one or more lines, 
beginning at the current line. 

COVerlay text 

Selectively replaces one or more characters in the current line with the same number of 
characters keyed in. 

CP [commandline] 

Transmits commands to the VM/SP control program environment during an editing session. 
CReplace text 

Replaces one or more characters in the current line. 
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XEDIT 


XEDIT (continued) CMS 

CURsor CMdline [colno IJL] [Priority n] 

Column [Priority n] 

File lineno [colno] [Priority n] 

Screen lineno [colno] [Priority n] 

Home [Priority n] 

Moves the cursor to a specified position and assigns a priority to the specified position. 
DELete [target|1] 

Deletes one or more lines from a file beginning with the current line. 

Down [n|*|l] 

Moves the line pointer down a specified number of lines toward the end of the file. 


DUPlicat [n [target 


Duplicates one or more lines beginning with the current line. 

EMSG [text] 
or 

[mmmnnns text] 

Displays a message at the terminal; or used in macros and modules that interface with XEDIT 
and whose messages follow VM/SP message rules. The severity determines whether or not 
the alarm sounds. 

EXPand [target|1] 

Repositions data in one or more lines that contain tab characters (X'05'). 
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XEDIT 


XEDIT (continued) CMS 

EXTract /operand [/operand [/operand]]... 

Used within a macro to get information about internal XEDIT variables or about file data. 

operand 

may be any one of the keywords listed below. 


ACTion 

HEX 

RESERved [*] 

UNTil 

ALT 

IMage 

RING 

UPDate 

APL 

IMPcmscp 

SCALe 

VARblank 

ARBchar 

INPmode 

SCOPE 

Verify 

AUTosave 

LASTLorc 

SCReen 

VERShift 

BASEft 

LASTmsg 

SELect 

WINdow 

BRKkey 

LENgth 

Seq8 

Width 

CASE 

LIBName 

SERial 

WRap 

CMDline 

LIBType 

SHADOW 

Zone 

COLOR field|* 

Line 

SIDcode 

= 

COLPtr 

LINENd 

Size 


COLumn 

LRecl 

SPAN 


CTLchar [char] 

LScreen 

SPILL 


CURLIne 

MACRO 

STAY 


CURSor 

MASK 

STReam 


DISPlay 

MEMber 

SYNonym [name|*] 


EFMode 

MSGLine 

SPILL 


EFName 

MSGMode 

STAY 


EFType 

NBFile 

STReam 


EOF 

NONDisp 

SYNonym [name)*] 


ESCape 

NULls 

TABLine 


ETARBCH 

NUMber 

TABS 


ETMODE 

PA n|*] 

TARGet 


FILler 

PACK 

TERMinal 


FILler 

PENDing (see below) 

TEXT 


FLscreen 

PF [n(^J 

TOF 


FMode 

Point [*] 

TOFEOF 


FName 

PREfix (see below) 

TOL 


FType 

RANge 

TRANSLat 


FULLread 

RECFm 

TRunc 



REMOte 

UNIQueid 



PENDing [BLOCK] [OLDNAME] name|* [target1[target2]] 
PREfix [Synonym name|*] 
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XEDIT 


XEDIT (continued) CMS 



Writes the edited file onto disk and optionally overrides the file identifier originally supplied. 
Find text 

Searches forward, starting with the current line, for the first line that corresponds to the text 
specified in the operand. 

FINDUp text 
FUp 

Searches backward, starting with the current line, for the first line that corresponds to the 
text specified in the operand. 

Forward [n|*|l] 

Scrolls (toward the end of the file) the operand-specified number of screen displays. 



Inserts all or part of a specified CMS file following the current line of the edit file. 

Help [MENU|HELP|name] 

Displays a list of all XEDIT subcommands and macros and their descriptions, formats, and 
parameters, or invokes the CMS HELP command. 

HEXType [target|1] 

Displays a specified number of lines in both hexadecimal and EBCDIC. This is a macro. 
Input [line] 

Inserts a single line into a file. Also used to leave edit mode for entry into input mode. 
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XEDIT 


XEDIT (continued) 


CMS 


Join [ALigned] [Column! 

IcursorJ 


[ALigned] fcolno 1 ... 

[ / str ing/J 

Combines two or more lines into one replacement line. The first format lets you join two 
lines at the column pointer or at the cursor. The second format lets you join two or more 
lines at a specified column number(s) or inserts a specified character string(s) before 
appending the next line. 

LEft [n|l] 

Allows viewing of columns not currently visible on the screen that lie to the left of the first 
column on the screen. 

LOAD [fn [ft [fm]]] [(options...[)]]| 

Reads a copy of the file being edited into virtual storage. This subcommand can only be 
issued from the XEDIT profile. Allows the macro to prompt for edit options or assign default 
values to edit variables. The LOAD subcommand has the same format and editing options as 
in the XEDIT command; however, the options specified in the XEDIT command override those 
specified in the LOAD subcommand. 

options: 

[Width nn] [NOSCreen] [PROFile macroname] [WINdow wname] 

[NOCLear] [NOPROFil] [NOMsg] [MEMber membername] 


options valid only in Update mode: 

[Update|NOUpdate] [ Seq8 INQSeq8] [Ctl fnl|NOCtl] 

[Merge] [UNtil filetype] 

[Incr nn] [SIDcode string] 

[Locate] target [subcommand] 

Scans file for a specified target, which (when found) becomes the current line. 

LOWercas [target| 1] 

Changes all uppercase letters to lowercase letters in one or more lines. 
LPrefix [text] 

Simulates writing in the prefix area of the current line. 

MACRO [macroline] 

Causes the specified operand to be executed as a macro. 
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MErge targetl target2 [col] 

Combines two sets of lines. The first set of lines is deleted and the second set is modified in 
place. 

MODify keyword 


keyword operands: 


ALT 

IMPcmscp 

SELect 

APL 

LASTLorc 

SERial 

ARBchar 

LINENd 

SHADOW 

AUtosave 

LRecl 

SIDcode 

BRKkey 

MACRO 

SPAN 

CASE 

MASK 

SPILL 

CMDline 

MSGLine 

STAY 

COLOR field 

MSGMode 

STReam 

COLPtr 

NONDisp 

SYNonym 

COLumn 

NULls 

TABLine 

CURLine 

PAn 

TABS 

DISPlay 

PACK 

TERMinal 

ENTer 

PFn 

TEXT 

ESCape 

PREfix [Synonym name] 

TOFEOF 

ETARBCH 

RANge 

TRunc 

ETMODE 

RECFm 

VARblank 

FILler 

REMOte 

Verify 

FMode 

SCALe 

VERShift 

FName 

SCOPE 

WRap 

FType 

SCReen 

Zone 

FULLread 



HEX 



IMage 




Displays a subcommand and its current operand values so that new values can be typed over 
the current ones and the subcommand immediately reentered. This is a macro. 

MOve targetl target2 

Moves one or more lines, beginning with the current line, to a specified place in the file. 

MSG [text] 

Displays a message in the message area of the screen. 
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Next [n | * | JL] 

Advances the line pointer a specified number of lines toward the end of the file. 

NFind text 

Searches forward for the first line that does not start with the text specified in the operand. 

NFINDUp text 
NFUp 

Searches backward for the first line that does not start with the text specified in the operand. 
Overlay text 

Replaces, selectively, one or more characters with non-blank characters starting at the first 
tab column of the current line. 

PARSE startcol Alphaword 
Number 
String ... 

Dblstring 

Target 

Word 

Line 

Helps in writing new macros by scanning the new macro(s) to see if the 
format-specified-operands match those in the macro. This is a macro. 


POWerinp 

Enters an input mode where data can be keyed in as though the screen were one long line. 
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PREServe 


settings saved include: 


ARBCHAR 

IMPCMSCP 

SHADOW 

AUTOSAVE 

LASTLORC 

SPAN 

CASE 

LINEND 

SPILL 

CMDLINE 

LRECL 

STAY 

COLOR 

MACRO 

STREAM 

COLPTR 

MASK 

SYNONYM 

CURLINE 

MSGMODE 

TABLINE 

DISPLAY 

NULLS 

TABS 

ESCAPE 

NUMBER 

TOFEOF 

ETARBCH 

PACK 

TRUNC 

FILLER 

PREFIX 

VARBLANK 

FMODE 

RECFM 

VERIFY 

FNAME 

SCALE 

WRAP 

FTYPE 

SCOPE 

ZONE 

HEX 

SERIAL 

= 

IMAGE 




Saves the settings of various XEDIT variables until a subsequent RESTORE subcommand is 
issued. 


PURge macroname 

Removes a copy of a macro in virtual storage. 




• 


PUT 

target 

1 

fn |ft [f 

m ill] 


Inserts one or more lines, starting at the current line, into the end of an existing file or into a 
new file or into a temporary file created by the editor. 


PUTD 

target 

1 

fn [ft [f 

"ill 



1 1= 

J JJ 


Inserts one or more lines, starting with the current line, into the end of an existing file or into 
a new file or into a temporary file. This command deletes the specified lines from the 
original file. 
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Query [option] 


options (specify only one each time): 


ACTion 

LASTLorc 

Seq8 

ALT 

LASTmsg 

SERial 

APL 

LENgth 

SHADOW 

ARBchar 

LIBName 

SIDcode 

AUtosave 

LIBType 

SIZe 

BASEft 

Line 

SPAN 

BRKkey 

LINENd 

SPILL 

CASE 

LRecl 

STAY 

CMDline 

LScreen 

STReam 

COLOR *|field 

MACRO 

SYNonym [*|name] 

COLPtr 

MASK 

TABLine 

COLumn 

MEMBER 

TABS 

CTLchar[char] 

MSGLine 

TARGet 

CURLine 

MSGMode 

TERMinal 

CURSor 

NBFile 

TEXT 

DISPlay 

NONDISP 

TOF 

EFMode 

NULls 

TOFEOF 

EFName 

NUMber 

TOL 

EFType 

PA [nil] 

TRANSLat 

ENTer 

PACK 

TRunc 

EOF 

PENDing (see below) 

UNIQueid 

EOL 

PF [nil] 

UNTil 

ESCape 

Point [*] 

UPDate 

ETARBCH 

PREfix (see below) 

VARblank 

ETMODE 

RANge 

Verify 

FILler 

RECFm 

VERShift 

FMode 

REMOte 

Width 

FName 

RESERved 

WINdow 

FType 

RING 

Zone 

FULLread 

SCALe 

= 

HEX 

SCOPE 


IMage 

SCReen 


IMPcmscp 

SELect 



PENDing [BLOCK] [OLDNAME]name|* 

PREfix [Synonym *|name] 

Displays the current setting of various editing options. 
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QUIT [n] 

Terminates the editing session and leaves the previous copy intact. 


READ CMDLINE 1 

r Tag 1 

All [Number] I 

[NOTAGJ 

Nochange [Number] 1 



Places data from the terminal into the console stack (LIFO). This subcommand generally is 
issued from a macro. 

RECover [n|*|l] 

Replaces a specified number of lines removed by a DELETE or PUTD subcommand or a D 
(delete) prefix subcommand. 

REFRESH 

Displays the screen. Issued from a macro, it presents the screen as of that moment in 
processing, without waiting for input. 


RENum 

[ startno 

finer] 


l 10 

1 


Renumbers the line numbers of VSBASIC and/or FREEFORT files. 

REPEat [target|1] 

Advances the line pointer and executes the last subcommand entered. 

Replace [text] 

Replaces the current line with a specified line or keyed in text, or deletes the current line and 
enters input mode. 

RESet 

Removes all prefix subcommands when the screen is in a “pending” or “incomplete" status. 
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RESTore 

Restores the settings of the XEDIT variables to the values in effect when last the PRESERVE 
subcommand was issued. 


RGTLEFT [n] 

View columns of data not currently visible on the screen. 


Right [n|l] 

Allows viewing of data in columns not currently visible on the screen. These columns are to 
the right of the right-most column on the screen. 



Enters the file that is currently being edited onto disk without returning control to CMS. 


SCHANGE [keynumber] 

Locates every occurrence of a string and changes the string only when specified to do so. 
This is a macro. 


SET option 

Changes the settings of various editing options while editing is in progress. 

options (must specify one): 

SET ALT n [p] 

Changes the number of alterations that have been made to the file since the last AUTOSAVE 
and/or since the last SAVE. 

[SET] APL ON|OFF 

Shows whether APL keys are available. 

[SET] ARBchar ON|OFF [char] 

Defines an arbitrary character used in a target definition. Note that the initial setting is OFF. 
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CMS 

[SET] AUtosave n mode 

OFF A 



Sets or resets the automatic save function of the editor. Note that the initial setting is OFF. 
[SET] BRKkey ON|OFF 

Specifies whether CP should break in when the "BRKKEY" (defined by CP TERMINAL 
BRKKEY) is pressed. 


[SET] CASE Uppercase Respect 

Mixed Ignore 

Controls letters entered, and specifies significance in target searches. 

[SET] CMDline On 
OFf 
Top 

Bottom 

Specifies the position of the command line on the screen. 

[SET] COLOR field [color] [exthi] [High|Nohigh] [PSs] 

* 

Associates specific colors with certain areas of the XEDIT screen. 

[SET] COLPtr ON|OFF 

Determines (on typewriter terminals) whether or not the column pointer (underscore) is 
displayed. 

[SET] CTLchar char Escape 

OFF 

Protect [color] [exthi] 

[High I NOHIGH I Invisible] [PSs] 

Noprotect[color] [exthi] 

[High I NOHIGH I Invisible] [PSs] 

OFF 

Defines control character. 
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CMS 


[SET] CURLine ON M[+n|-n] | [+l|-]n 

Defines the nth line of the screen as the current line. Note that, on initial setting, the n is the 
middle line of the screen. 

[SET] DISPlay nl [n2|*] 

Specifies which selection level of lines (as displayed by SET SELECT) are displayed. 


[SET] ENTer 


BEFORE 

AFTER 

ONLY 

IGNORE 


string 

NULLKEY 

COPYKEY 

TABKEY 


Defines a meaning for the hardware ENTER key or removes the meaning associated with the 
ENTER key. 


[SET] ESCape ON|OFF [char] 

Allows entry of subcommand (on typewriter terminals) when in input mode without leaving 
input mode. 


[SET] ETARBCH ON|OFF [char] 

Defines an extended arbitrary character used in a target definition within a DBCS string. The 
initial setting is OFF. 

[SET] ETMODE ON|OFF 

Inform the editor that there are double-byte characters in the file. The initial setting is OFF. 
[SET] FILler [char] 

Defines a character to be used when expanding a line (see EXPAND subcommand). 

[SET] FMode fm 

Changes the filemode of the edited file. 

[SET] FName fn 

Changes the filename of the edited file. 

[SET] FType ft 

Changes the filetype of the edited file. 

[SET] FULLread ON|OFF 

Allows 3270 null characters to be recognized in the middle of screen lines. 

[SET] HEX ON|OFF 

Allows subcommand operands and targets to be specified in hexadecimal. Note that the 
initial setting is OFF. 

[SET] IMage ON|OFF|Canon 

Determines how tab characters (X'05') and backspace characters (X'16') are handled. 
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[SET] IMPcmscp ON|OFF 

Determines whether or not non-XEDIT recognized subcommands are transmitted implicitly to 
CMS, and later to CP, for execution. 

[SET] LASTLorc line 

Specifies the contents of the LASTLORC subcommand. (Used within a macro.) 

[SET] LINENd ON|OFF [char] 

Determines whether or not # (pound sign) or other character is used as the line end 
character. 

[SET] LRecl n|* 

Defines a new logical record length for writing file to disk. 

[SET] MACRO ON|OFF 

Controls sequence of editor's search for subcommands and macros. Note that the initial 
setting is OFF. 

[SET] MASK Define 

Immed [text] 

Modify 

Changes contents of mask. Note that the initial setting is a blank line. 

[SET] MSGLine ON M[+n|-n] | [+|-]n [p|JL] [Overlay] 

OFF 

Defines the location of the message line on the screen, and the maximum number of lines 
that a message may occupy. 

[SET] MSGMode ON [Short|Long] 

OFF 

Controls message display. Note that the initial setting is ON LONG. 


Chapter 4. CP, CMS, GCS, TSAF, RSCS, and IPCS Commands 259 




XEDIT 


XEDIT (continued) CMS 

[SET] NONDisp [char] 

Defines a character to use in place of a nondisplayable character. 

[SET] NULls ON|OFF 

Specifies whether trailing blanks in each line are written to the screen as blanks (X'40') or 
nulls (XW). Note that the initial setting is OFF. 

[SET] NUMber ON|OFF 

Determines whether or not line numbers are displayed in prefix area. Note that the initial 
setting is OFF. 


[SET] PAn 

'BEFORE' 


'string 


AFTER 


NULLKEY 


ONLY 


COPYKEY 


.IGNORE, 


.TABKEY . 


Defines a meaning for a specified hardware attention (PA) key or removes the meaning 
associated with the specified PA key. 

[SET] PACK ON|OFF 

Specifies whether or not packed file is entered on disk. 

[SET] PENDing ON|BLOCK|ERROR string 
OFF 

Controls the execution of a prefix macro and the status of the screen while the prefix macro 
is being executed. 


[SET] PFn 

BEFORE" 


’string 


AFTER 


NULLKEY 


ONLY 


COPYKEY 


.IGNORE, 


.TABKEY , 


Defines or removes a meaning for a specified program function (PF) key. Note that TABKEY 
is the initial setting of the PF4 dey. 

[SET] Point .symbol [OFF] 

Defines or redefines the symbolic name for the current line. 
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[SET] PREfix ON [ LEFT !Right] 

OFF 

Nulls [ LEFT I Right] 
or 

PREfix Synonym newname oldname 
Controls display of the prefix area. Also defines a synonym for a prefix subcommand. 


[SET] RANge target1 target2 

Defines new limits for line pointer movement. 

[SET] RECFm F|V|FP|VP 

Defines the record format for the file. 

[SET] REMOte ON|OFF 

Controls the way XEDIT handles the display, in terms of data transmission. 

[SET] RESERved M[+n|-n] | [+|- n][color] [exthi] [PSs] High 

[text] 

Off Nohigh 

Reserves a specific line on the screen for displaying blank or specified information with or 
without any of the following features: color, extended highlighting, highlighting, and 
programmed symbol set. 

[SET] SCALe ON [M[+n|-n] | [±|-]n] 

OFF 

Displays a scale line under the current line (the default) or on a specified line. 


[SET] SCOPE Display|ALL 

Specifies the set of lines on which the editor operates. 

[SET] SCReen n [ HORIZONTAL I Vertical] 

Size si [s2 [s3...[sn]]j 
Width wl [w2 [w3...[wnj]j 

Define sll swl shl svl [sl2 sw2 sh2 sv2]... 

Divides the screen into a specified number of logical screens to allow editing of multiple files 
or multiple views of the same file. 
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[SET] SELect [+|-] n [target] 

Designates a “selection level” for specified lines. A selection level is a positive value 
assigned to a line in a file. 

[SET] SERial ON fincrno 

F 

ALL [incrno 
1 1000 

string [incrno 

[10 

OFF 

Controls file serialization. 

[SET] SHADOW ON|OFF 

Displays a notice (called a shadow line) that indicates how many lines have been excluded 
from the display. 

[SET] SIDcode [string] 

Inserts a character string in every line of an update file. 

[SET] SPAN ON [Blank fnll 
[Nonblank l*JJ 

OFF 

Specifies whether a target-search character string must be included in one line or span a 
certain number of lines. Note that the initial setting is OFF Blank 2. 
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[SET] SPILL ON|OFF|WORD 

Specifies if data is spilled onto new lines or lines are truncated following these 
subcommands: CHANGE, CINSERT, COVERLAY, CREPLACE, EXPAND, GET, INPUT, MERGE, 
OVERLAY, REPLACE, SHIFT, (and macros that use these subcommands internally, including 
CAPPEND, JOIN and PRFSHIFT( >,>>)). 

[SET] STAY ON|OFF 

Specifies whether or not the line pointer moves when target-search object is not found. Note 
that the initial setting is OFF. 

[SET] STReam ON|OFF 

Specifies whether to search entire file or only the current line for a character string. Note 
that the initial setting is ON. 

[SET] SYNonym ON|OFF 
or 

SYNonym [LINEND char] newname [n] oldname 
or 

SYNonym [LINEND char] newname [n[formatl...formatn]] 
oldname[&l...&n] 

Specifies whether or not to look for synonyms. Also assigns a synonym to any existing 
subcommand or macro (except prefix subcommands or prefix macros) and defines an 
abbreviation for the synonym. 

[SET] TABLine ON [M[+n|-n] | [+|-]n] 

OFF 

Displays a “T" in every tab column according to current tab settings. 

[SET] TABS nl[n2 ... n28] 

Defines the logical tab stops for a file. 

[SET] TERMinal Typewriter 
Display 

Specifies whether a terminal is to be used in line mode or in full screen mode. 
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[SET] TEXT ON|OFF 

Shows whether keys are available. 

[SET] TOFEOF ON|OFF 

Controls the display of Top of File, End of File, Top of Range, and End of Range null lines. 

Note that the Initial setting is ON. 

[SET] TRANSLat charl char2 [charl char2] ... 

OFF 

Controls uppercase translation of specified characters. This option is designed for terminals 
whose keyboards support characters other than English. 

[SET] TRunc n|* 

Defines last column in which data may be entered. 

[SET] VARblank ON|OFF 

Controls whether or not the number of blanks between two words is significant in target 
search. Note that the initial setting is OFF. 


[SET] Verify [ON 1 [[Hex] startcol endcol] ... 

[offJ 

Controls whether or not subcommand(s)-changed lines are to be displayed. Also defines 
columns to be displayed on screen. Data may also be displayed in hexadecimal. 

[SET] WRap ON|OFF 

Controls use of wraparound. Note that the initial setting is OFF. 

[SET] Zone zonel zone2 
* 

Defines starting and ending column of each record for target search scanning. 

[SET] = string 

Inserts specified string into the equal buffer (see = subcommand). 
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SHift Left fcols [target]! 

Right [ 1 [ 1 JJ 

Moves data either to the left or to the right. Note that data loss is possible. 

SI 

Continually add lines for indented text to a file. A line is added immediately following the line 
that contains the cursor. The cursor is positioned at the column where the text on the 
previous line begins. 

SORT target |a| coll col2 [coll col2]... 

Arranges a specified number of file lines in ascending or descending EBCDIC sequence 
according to specified sort columns. 


SOS option 



options: 

ALarm 

POP 


CLEAR 

PUsh 


LINEAdd 

TABB [n| 

11] 

LINEDel 

TABCmd 


NUlls 

TABCMDB 

[n 

NUlls ON 

TABCMDF 

[n 

NUlls OFF 

PFn 

TABF [n| 

1] 


Provides a set of functions used mainly in XEDIT macros or assigned to PF keys. 


SPlit [Aligned] [COLUMN ] 
[CURSORJ 


or 


[Aligned] 


colno 


[ BEFORE ] /string/ 
After J 


Splits a line into two or more lines at the column pointer or at the cursor. The second format 
splits a line into several lines. This is a macro. 
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SPLTJOIN 

Either splits a line or joins two lines, depending on the position of the cursor on a file line. If 
the cursor is positioned before or at the last non-blank character, the line is split (at the 
cursor position). If the cursor is positioned after the last non-blank character on a line (that 
is, after the end of the data on a line), the next line is appended, starting at the cursor 
position. This is a macro. 


STAck 


target (startcol flength]| 

i [i U J] 


Places part or all of a specified number of lines into the console stack, starting with the 
current line. 


STATus [filename] 

Displays the SET subcommand options and their current settings or creates an XEDIT macro 
that contains the SET subcommands with their current settings. This is a macro. 

TOP 

Moves the line pointer to the null line above the first line of the file or of the range (see SET 
RANGE). 


266 


VM/SP Quick Reference 




XEDIT 


XEDIT (continued) CMS 

TRAnsfer keyword . . . 

keywords: (more than one can be specified) 


APL 

IMage 

PFn 

TABLine 

ARBchar 

IMPcmscp 

Point 

TABS 

AUtosave 

LASTmsg 

PREfix 

TARGet 

CASE 

LENgth 

RANge 

TERMinal 

CMDline 

Line 

RECFm 

TEXT 

COLPtr 

LINENd 

RESERved 

TOF 

COLumn 

LRecl 

SCALe 

TOFFEO 

CTLchar[char] 

LScreen 

SCReen 

Trunc 

CURLine 

MACRO 

Seq8 

UPDate 

CURSor 

MASK 

SERial 

VARblank 

EOF 

MSGMode 

SIDcode 

Verify 

ESCape 

NBFile 

Size 

VERShift 

FILler 

NONDisp 

SPAN 

Width 

FMode 

NULls 

STAY 

WRap 

FName 

NUMber 

STReam 

Zone 

FType 

PACK 

SYNonym[name] 

= 


HEX 

Accesses, within a macro, specified editing variables and places their values in the console 
stack for subsequent reading by the EXEC 2 &READ control statements. 

Type [target| 1 ] 

Displays a specified number of lines, starting with the current line. 

Up [n|*H] 

Moves the line pointer a specified number of lines toward the top of the file. 

UPPercas [target|1] 

Translates all lowercase characters to uppercase ones, starting at the current line. 

Xedit [fn [ft [fm]]] [(options...[)]] 

Edits multiple files in virtual storage. 

Options: are the same as the command options (see XEDIT command). 
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The XEDIT Prefix subcommands (line subcommands) are used as follows: 

Prefix Meaning and/or Action 

A Add one line immediately after the line in which subcommand is entered 

nA Add n lines 

An Add n lines 

C Copy one line; must have F or P prefix subcommand to indicate destination of line 

Cn Copy n lines 

nC Copy n lines 

CC Copy block of lines 

D Deletes one line 

Dn Delete n lines 

nD Delete n lines 

DD Delete block of lines 

E Extend logical line by one more physical line 

F Data is entered following this point (using the C or M prefix subcommand) 

I Insert one line immediately following the line in which prefix subcommand is entered 

nl Insert n lines 

In Insert n lines 

M Move one line from one location to another in the file 

Mn Move n lines 

nM Move n lines 

MM Move block of lines 

P Data is entered preceding this point (using the C or M prefix subcommands 
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S Show all lines 

S* Show all lines 

Sn Show the first n lines 

S + n Show the first n lines 

nS Show the first n lines 

S-n Show the last n lines 

SCALE Display the scale on this line 

SI Continually add lines for indented text to a file. A line is added immediately following the 

line that contains the cursor. The cursor is positioned at the column where the text on the 
previous line begins. 

TABL Displays a "T" in every tab column in the line 

X Exclude one line from display 

Xn Exclude n lines 

nX Exclude n lines 

XX Exclude a block of lines 

.xxxx Assigns xxxx as symbolic name to this line 

< Shift one line one column to the left 

<n Shift one line n columns to the left 

n< Shift one line n columns to the left 

< < Shift a block of lines n columns to the left 

< < n Shift a block of lines n columns to the left 

n < < Shift a block of lines n columns to the left 

/[n] Make this line current and move the column 
[n]/ pointer under the nth column. 

> Shift one line one column to the right 

> n Shift one line n columns to the right 

n> Shift one line n columns to the right 

> > Shift a block of lines n columns to the right 

> > n Shift a block of lines n columns to the right 

n> > Shift a block of lines n columns to the right 
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" Duplicates one line (must be a double quote symbol) 

"n Duplicate line n times 

n" Duplicate line n times 

"" Duplicate block of lines 

""n Duplicate block n times 

n"" Duplicate block n times 

£ 


| XMITMSG CMS 

| Retrieves a message from a CMS message repository file or your own message repository file. 

| XMITMSG msgnumber sublist [(options ... [)]] 

| options: 


[FORmat nn] 

[LINe nn|*] 

[LETter a] 

[APPLID applid] 

[CALLER name] 

[VAR] 



[SYSLANG] 
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ZAP 

Modifies or dumps MODULE, LOADLIB, or TXTLIB files. 

( MODULE 

LOADLIB V [libnamel ... 1ibname3][(options...[)]] 
TXTLIB J 

options: 

[ TERM I INPUT filename] [ PRINT I NOPRINT] 

Control Statements: 

BASE address 

DUMP ( membername1 csectname [startaddress [endaddress]] 
JmodulenameJ ALL 

LOG (fixnum) [ZAPLOG|filetype [userdata]] 

NAME (membername|modulename} [csectname] 

REP disp data 

(VERIFY|VER} disp data 

* comment 

END 


CMS 
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Summary of Changes 


The HELP Facility 

The HELP Facility has been enhanced to include National Language 
Support and to improve performance and usability. These 
enhancements include: 

BRIEF layer of HELP for a subset of frequently-used commands 

RELATED information 

New HELP command options 

Toggling ability 

Windowing of the BRIEF layer 

MOREHELP command 

Simplified screens and syntax notation 

New control section keywords 

Enhancement of the DEFAULTS command 

National Language Support 


NLS Parser Summary 

The CMS parsing facility parses and translates command name 
arguments. It is important to National Language Support (NLS) 
because it lets users enter commands in their own national 
language. 
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Enhancements for EXECs in Storage 

An optional Installation Discontiguous Shared Segement (DCSS) is 
added to contain frequently used EXECs and Editor Macros that your 
installation provides. All users can access the DCSS and share the 
same executing copy of the EXECs. 


Advanced Printer Subsystem Support 

The SPOOL System Service allows authorized users an interface for 
communication between CP and a printer subsystem. 

The DESTination option allows you to select a specific printer or 
punch to process your print, punch, or console file. 

The CMS PRINT Command has been enhanced to support an 
Oversize option to print files that have records larger than the virtual 
printer's character size. 


Transparent Services Access Facility 

Transparent Services Access Facility is a facility that lets users 
connect to and communicate with local or remote virtual machines 
within a group of systems. 
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Enhanced 3270 Usability 


Usability features for 3270 display stations have been enhanced. 
The VM logo message at the top of the screen is changed from 
“VM/370” to “VIRTUAL MACHINE/SYSTEM PRODUCT” and users 
can now log on directly from the logo screen. 


New Commands for Release 5 


ALARM VSCREEN 

CLEAR VSCREEN 

CLEAR WINDOW 

CONVERT COMMANDS 

CMSSERV 

CURSOR VSCREEN 

DEFINE VSCREEN 

DEFINE WINDOW 

DELETE VSCREEN 

DELETE WINDOW 

DISKMAP 

DROP WINDOW 

GET VSCREEN 

HIDE WINDOW 

ITASK 

LANGGEN 

LANGMERG 

MAXIMIZE WINDOW 

MINIMIZE WINDOW 

MOREHELP 

PARSECMD 

POP WINDOW 

POSITION WINDOW 

PRELOAD 

PUT SCREEN 

PUT VSCREEN 

QUERY APL 

QUERY BORDER 

QUERY CHARMODE 

QUERY CMSPF 


QUERY CURSOR 
QUERY DISPLAY 
QUERY FULLREAD 
QUERY FULLSCREEN 
QUERY HIDE 
QUERY KEY 
QUERY LANGLIST 
QUERY LANGUAGE 
QUERY LINEND 
QUERY LOCATION 
QUERY LOGFILE 
QUERY NONDISP 
QUERY REMOTE 
QUERY RESERVED 
QUERY SHOW 
QUERY TEXT 
QUERY VSCREEN 
QUERY WINDOW 
QUERY WMPF 
REFRESH 

RESTORE WINDOW 
ROUTE 
SCROLL 
SET APL 
SET BORDER 
SET CHARMODE 
SET CMSPF 
SET FULLREAD 
SET FULLSCREEN 


SET LANGUAGE 

SET LINEND 

SET LOCATION 

SET LOGFILE 

SET NONDISP 

SET REMOTE 

SET RESERVED 

SET VSCREEN 

SET WINDOW 

SET WMPF 

SHOW WINDOW 

SIZE WINDOW 

SNTMAP 

SPGEN 

SPLOAD 

UTILITY 

VALIDATE 

VMFASM 

VMFDOS 

VMFLKED 

VMFLOAD 

VMFMAC 

VMFMERGE 

VMFREMOV 

VMFTEXT 

VMFZAP 

WAITREAD VSCREEN 
WAITT VSCREEN 
WRITE VSCREEN 
XMITMSG 
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TSAF Commands 


• ADD LINK 

• DELETE LINK 

• QUERY 

• RUNTSAF 

• STOP TSAF 


Changed Commands for Release 5 


ACCESS 

BACKSPAC 

CHANGE 

CLOSE 

DEFAULTS 

DETACH 

DRAIN 

DUMPSCAN 

EXECDROP 

EXECIO 

EXECMAP 

EXECUPDT 

FILEDEF 

FLUSH 

FORMAT 

GLOBAL 

HELP 

INCLUDE 


IPL 

LOAD 

OVERRIDE 

PRINT 

PURGE 

QUERY 

REPEAT 

SAVENCP 

SET 

SPOOL 

SPTAPE 

START 

TERMINAL 

TRANSFER 

TXTLIB 

UPDATE 

VARY 

XEDIT 
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* command (CMS) 53 

* command (CP class any) 53 

* command (GCS) 53 

* command (RSCS) 53 

#CP command (CP class any) 53 


0 

ACCESS command (CMS) 54 
ACCESS command (GCS) 54 
ACNT command (CP class A) 54 
ADD LINK command (TSAF) 55 
ADSTOP command (CP class G) 55 
ALARM VSCREEN command (CMS) 55 
AMSERV command (CMS) 55 
APAR command (1PCS) 56 
ASMGEND command (CMS) 56 
ASM3705 command (CMS) 56 
ASSEMBLE command (CMS) 57 
assembling a source file 24 
ASSGN command (CMS) 58 
ATTACH command (CP class B) 58 
ATTN command (CP class G) 58 
AUTOLOG command (CP class A,B) 59 


B (CMS Border Command) 59 
BACKSPAC command (CP class D) 59 
BACKSPAC command (RSCS) 59 
BEGIN command (CP class G) 59 


0 

C (CMS Border Command) 60 
CATCHECK command (CMS) 60 
CHANGE command (CP class D) 61 
CHANGE command (CP class G) 62 
CHANGE command (RSCS) 63 
CLEAR VSCREEN command (CMS) 63 
CLEAR WINDOW command (CMS) 63 
CLOSE command (CP class G) 64 
CMD command (RSCS) 64 
CMDCALL command (CMS) 64 
CMS (Conversational Monitor Commands) 
commands 
* 53 

ACCESS 54 
ALARM VSCREEN 55 
AMSERV 55 
ASMGEND 56 
ASM3705 56 

ASSEMBLE 57 
ASSGN 58 

B (CMS Border Command) 59 
C (CMS Border Command) 60 
CATCHECK 60 
CLEAR VSCREEN 63 
CLEAR WINDOW 63 
CMDCALL 64 
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CMSBATCH 64 
CMSGEND 65 
CMSSERV 65 
COMPARE 65 
CONVERT COMMANDS 66 
CONWAIT 66 
COPYFILE 67 
CP 67 

CURSOR VSCREEN 69 

D (CMS Border Command) 69 

DDR 70 

DEBUG 72 

DEFAULTS 73 

DEFINE VSCREEN 77 

DEFINE WINDOW 78 

DELETE VSCREEN 78 

DELETE WINDOW 79 

DESBUF 79 

DIRECT 80 

DISK 82 

DISKMAP 82 

DLBL 84 

DOSLIB 86 

DOSLKED 86 

DROP WINDOW 87 

DROPBUF 87 

DSERV 88 

EDIT 95 

ERASE 102 

ESERV 102 

EXEC 103 

EXEC 2 108 

EXECDROP 118 

EXECIO 119 

EXECLOAD 120 

EXECMAP 120 

EXECOS 121 

EXECSTAT 121 

EXECUPDT 121 

EXPAND 122 

F (CMS Border Command) 122 
FETCH 123 
FILEDEF 124 
FILELIST 126 


FINIS 127 
FORMAT 128 
GENDIRT 130 
GENIMAGE 130 
GENMOD 131 
GENMSG 131 
GEN3705 131 

GET VSCREEN 132 
GLOBAL 132 
GLOBALV 133 

H (CMS Border Command) 134 
HB 134 
HELP 135 
HELPCONV 135 
HI 135 

HIDE WINDOW 136 

HO 136 

HT 136 

HX 137 

IDENTIFY 137 

IMAGELIB 137 

IMAGEMOD 138 

IMMCMD 138 

INCLUDE 139 

ITASK (CMS) 141 

L (CMS Border Command) 142 

LABELDEF 142 

LANGGEN 143 

LANGMERG 143 

LISTDS 143 

LISTFILE 144 

LISTIO 144 

LKED 145 

LOAD 145 

LOADLIB 146 

LOADMOD 146 

M (CMS Border Command) 148 

MACLIB 148 

MAKEBUF 149 

MAXIMIZE WINDOW 149 

MINIMIZE WINDOW 150 

MODMAP 150 

MOREHELP 152 
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MOVEFILE 152 

N (CMS Border Command) 153 

NAMEFIND 153 

NAMES 154 

NCPDUMP 154 

NOTE 157 

NUCXDROP 157 

NUCXLOAD 158 

NUCXMAP 158 

O (CMS Border Command) 158 
OPTION 158 
OSRUN 159 

P (CMS Border Command) 160 

PARSECMD 160 

PEEK 161 

POP WINDOW 163 

POSITION WINDOW 163 

PRELOAD 164 

PRINT 164 

PSERV 168 

PUNCH 168 

PUT SCREEN 169 

PUT VSCREEN 169 

QUERY 170 

R (CMS Border Command) 179 

RDR 179 

RDRLIST 179 

READCARD 180 

RECEIVE 180 

REFRESH 181 

RELEASE 181 

RENAME 182 

RESERVE 183 

RESTORE WINDOW 183 

REXX 184 

RO 195 

ROUTE 195 

RSERV 196 

RT 196 

RUN 196 

S (CMS Border Command) 197 
SAVENCP 197 
SCROLL 199 
SENDFILE 200 


SENTRIES 200 
SET 200 
SETABBREV 201 
SET APL 201 
SET AUTOREAD 201 
SET BLIP 201 
SET BORDER 202 
SET CHARMODE 202 
SET CMSPF 202 
SET CMSTYPE 203 
SET DOS 203 
SET DOSLNCNT 203 
SET DOSPART 203 
SET EXECTRAC 203 
SET FULLREAD 204 
SET FULLSCREEN 204 
SET IMESCAPE 204 
SET IMPCP 204 
SET IMPEX 205 
SET INPUT 205 
SET INSTSEG 205 
SET LANGUAGE 205 
SET LDRTBLS 206 
SET LINEND 206 
SET LOCATION 206 
SET LOGFILE 206 
SET NONDISP 206 
SET NONSHARE 207 
SET OUTPUT 207 
SET PROTECT 207 
SET RDYMSG 207 
SET REDTYPE 208 
SETRELPAGE 208 
SET REMOTE 208 
SET RESERVED 208 
SET SYSNAME 209 
SET TEXT 209 
SET TRANSLATE 209 
SET UPSI 209 
SET VSCREEN 210 
SET WINDOW 210 
SET WMPF 210 
SETKEY 215 
SETPRT 215 



SHOW WINDOW 215 

SIZE WINDOW 216 

SNTMAP 217 

SO 217 

SORT 217 

SPGEN 218 

SPLOAD 219 

SSERV 222 

START 222 

STATE/STATEW 224 

SVCTRACE 226 

SYNONYM 226 

TAPE 228 

TAPEMAC 229 

TAPPDS 229 

TE 230 

TELL 230 

TRAPRED 234 

TS 234 

TXTLIB 235 

TYPE 235 

UPDATE 236 

UTILITY 236 

VALIDATE 237 

VMFASM 238 

VMFDOS 238 

VMFLKED 239 

VMFLOAD 239 

VMFMAC 239 

VMFMERGE 239 

VMFNLS 240 

VMFPLC2 240 

VMFREMOVE 241 

VMFTXT 241 

VMFZAP 241 

WAITREAD VSCREEN 242 

WAITT VSCREEN 242 

WRITE VSCREEN 243 

X (CMS Border Command) 243 

XEDIT 244 

XMITMSG 270 

ZAP 271 

CMS Border Commands 
B 59 


C 60 
D 69 
F 122 
H 134 
L 142 
M 148 
N 153 
P 160 
R 179 
S 197 
X 243 

CMS DDR command return codes 42 
CMS fileid 32 
CMS immediate commands 
HB 134 
HI 135 
HO 136 
HT 136 
HX 137 
RO 195 
RT 196 
SO 217 
TE 230 
TS 234 

CMS program development facilites 22 
CMS return codes 39 
CMSBATCH command (CMS) 64 
CMSGEND command (CMS) 65 
CMSSERV (CMS command) 65 
COMPARE command (CMS) 65 
Control Program (CP) 

See CP (Control Program) commands 
conventions for notations 48 
Conversational Monitor System (CMS) 
See CMS (Conversational Monitor 
Commands) commands 
CONVERT command (IPCS) 66 
CONVERT COMMANDS (CMS) 66 
CONVIPCS EXEC (IPCS) 66 
CONWAIT command (CMS) 66 
COPYFILE command (CMS) 67 
correcting errors 25 
COUPLE command (CP class G) 67 
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CP (Control Program) commands 
* (class any) 53 
#CP (class any) 53 
ACNT (class A) 54 
ADSTOP (class G) 55 
ATTACH (class B) 58 
ATTN (class G) 58 
AUTOLOG (class A,B) 59 
BACKSPAC (class D) 59 
BEGIN (class G) 59 
CHANGE (class D) 61 
CHANGE (class G) 62 
CLOSE (class G) 64 
COUPLE (class G) 67 
CP (class any) 67 
CPTRAP (class C) 69 
DCP (class C,E) 70 
DEFINE (class A,B) 74 
DEFINE (class G) 75 
DETACH (class B) 79 
DETACH (class G) 79 
DIAL (class any) 80 
DISABLE (class A,B) 81 
DISCONN (class any) 81 
DISPLAY (class G) 83 
DMCP (class C,E) 85 
DRAIN (class D) 87 
DUMP (class G) 88 
ECHO (class G) 94 
ENABLE (class A,B) 101 
EXTERNAL (class G) 122 
FLUSH (class D) 127 
FORCE (class A) 127 
FREE (class D) 129 
HALT (class A) 134 
HOLD (class D) 136 
INDICATE (class A) 139 
INDICATE (class E) 139 
INDICATE (class G) 140 
IPL (class G) 140 
LINK (class G) 143 
LOADBUF (class D) 146 
LOADVFCB (class G) 147 
LOCATE (class E) 147 


LOCK (class A) 147 
LOGOFF (class any) 147 
LOGON (class any) 147 
MESSAGE (class A,B) 149 
MESSAGE (class any) 149 
MIGRATE (class A) 150 
MONITOR (class A,E) 150 
MSGNOH (class A,B) 153 
NETWORK (class A) 155 
NETWORK (class B) 156 
NOTREADY (class G) 157 
ORDER (class D) 159 
ORDER (class G) 159 
PER (class A,B t C,D,E,F,G) 161 
PURGE (class D) 168 
PURGE (class G) 169 
QUERY (class A) 172 
QUERY (class B) 173 
QUERY (class C) 173 
QUERY (class D) 174 
QUERY (class E) 175 
QUERY (class F) 175 
QUERY (class G) 176 
QVM (class A) 179 
READY (class G) 180 
REPEAT (class D) 182 
REQUEST (class G) 182 
RESET (class G) 183 
REWIND (class G) 184 
SAVESYS (class E) 197 
SCREEN (class G) 198 
SEND (class G) 199 
SET (class A) 211 
SET (class B) 211 
SET (class E) 212 
SET (class F) 212 
SET (class G) 213 
SHUTDOWN (class A) 215 
SLEEP (class any) 216 
SMSG (class G) 216 
SMSG (RSCS) 217 
SPACE (class D) 218 
SPMODE (class A) 219 
SPOOL (class G) 220 
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SPTAPE (class D) 221 
START (class D) 222 
STCP (class C) 225 
STORE (class G) 226 
SYSTEM (class G) 227 
TAG (class G) 227 
TERMINAL (class G) 231 
TRACE (class G) 232 
TRANSFER (class D) 232 
TRANSFER (class G) 233 
UNLOCK (class A) 235 
VARY (class B) 237 
VMDUMP (class G) 237 
WARNING (class A,B) 242 
CP command (CMS) 67 
CP command (CP class any) 67 
CP command (RSCS) 68 
CP DIRECT return codes 41 
CP privilege classes 50-53 
CPQUERY command (RSCS) 68 
CPTRAP command (CP class C) 69 
creating an assembler language source 
file 22 

assembling a source file 24 
correcting errors 25 
erasing unwanted files 28 
testing and correcting 26 
CURSOR VSCREEN command (CMS) 69 


0 

D (CMS Border Command) 69 
DCP command (CP class C,E) 70 
DDR command (CMS) 70 
DEBUG command (CMS) 72 
subcommands 72 
BReak 72 
CAW 72 
CSW 72 
DEFine 72 
DUmp 72 


GO 72 
GPR 73 
HX 73 
ORigin 73 
PSW 73 
RETurn 73 
SET 73 
STore 73 
X 73 

DEFAULTS command (CMS) 73 
DEFINE command (CP class A,B) 74 
DEFINE command (CP class G) 75 
DEFINE command (RSCS) 77 
DEFINE VSCREEN command (CMS) 77 
DEFINE WINDOW command (CMS) 78 
DELETE command (RSCS) 78 
DELETE LINK command (TSAF) 78 
DELETE VSCREEN command (CMS) 78 
DELETE WINDOW command (CMS) 79 
DESBUF command (CMS) 79 
DETACH command (CP class B) 79 
DETACH command (CP class G) 79 
developing program facilities 24 
developing programs 22 
DIAL command (CP class any) 80 
DIRECT command (CMS) 80 
DISABLE command (CP class A,B) 81 
DISCONN command (CP class any) 81 
DISCONN command (RSCS) 82 
disconnect function 9 
DISCONNECT status 9 
disconnection of terminal 9 
DISK command (CMS) 82 
. DISKMAP command (CMS) 82 
DISPLAY command (CP class G) 83 
display terminals, status action 11 
DLBL command (CMS) 84 
DLBL command (GCS) 85 
DMCP command (CP class C,E) 85 
DOSLIB command (CMS) 86 
DOSLKED command (CMS) 86 
DRAIN command (CP class D) 87 
DRAIN command (RSCS) 87 
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DROP WINDOW command (CMS) 87 
DROPBUF command (CMS) 87 
DSERV command (CMS) 88 
DUMP command (CP class G) 88 
DUMPSCAN command (GCS) 89 
DUMPSCAN command (IPCS) 90 
subcommands 90-93 
+ (increment) 90 
(null line) 90 
& 90 

&name 90 
- (decrement) 90 
? 90 
Aregs 90 
ARIOBLOK 90 
C 90 
CHain 91 
CMS 91 
CMSPoint 91 
CORtable 91 
Display 91 
DOSPoint 91 
DUMPID 91 
END 91 
FORMat 94 
G 92 
HELP 92 
HEX 94 
HX 92 
IPCSMAP 92 
Locate 92 
Locate Up 92 
MAPA 93 
MAPN 93 
Mregs 93 
MRIOBLOK 93 
OSPoint 93 
Print 93 
PRT 93 
QUIT 93 
Regs 93 
RIOblok 93 
Scroll 94 
Scrollu 94 


SYMP 94 
USERMAP 94 
VIOblok 94 
Vmblok 94 


0 

ECHO command (CP class G) 94 

EDIT command (CMS) 95 

subcommands and macros 95-101 
&DUP 95 
&MOVE 95 
? 95 
ALter 95 
AUTOsave 96 
BAckward 96 
Bottom 96 
CASE 96 
Change 96 
CMS 96 
DELete 96 
DOwn 96 
DString 96 
FILE 97 
Find 97 
FMode 97 
FName 97 
FORMat 97 
FOrward 97 
Getfile 97 
IMAGE 97 
Input 98 
LINEmode 98 
Locate 98 
LONG 98 
Next 98 
nnnnnnnn 101 
Overlay 98 
PREserve 98 
PROMPT 98 
QUIT 98 
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RECfm 99 
RENum 99 
REPEAT 99 
Replace 99 
REStore 99 
RETURN 99 
REUSE 99 
SAVE 99 
Scroll 100 
SERial 100 
SHORT 100 
STACK 100 
TABSet 100 
TOP 100 
TRUNC 100 
Type 100 
Up 101 
Verify 101 
X 101 
Y 101 
Zone 101 

ENABLE command (CP class A,B) 101 
ERASE command (CMS) 102 
erasing unwanted files 28 
ESERV command (CMS) 102 
ETRACE command (GCS) 102 
EXEC command (CMS) 103 
built-in functions 106 
&LITERAL 106 
&variable = &CONCAT 106 
&variable = &DATATYPE 106 
&variable = &LENGTH 106 
&variable = &SUBSTR 106 
control statements 103 
&ARGS 103 
&BEGEMSG 103 
&BEGPUNCH 103 
&BEGSTACK 103 
&BEGTYPE 103 
&CONTINUE 103 
&CONTROL 104 
&EMSG 104 
&END 104 
&ERROR 104 


&EXIT 104 
&GOTO 104 
&HEX 104 
&IF 104 
&LOOP 104 
&PUNCH 105 
&READ 105 
&SKIP 105 
&SPACE 105 
&STACK 105 
&TIME 105 
&TYPE 105 
&variable 103 
special variables 106 
&* and &$ 106 

&0 106 
&DISK* 106 
&DISK? 106 
&DISKx 106 
&DOS 106 
&EXEC 106 
&GLOBAL 107 
&GLOBALn 107 
&INDEX 107 
&LINENUM 107 
&n 106 

&READFLAG 107 
EXEC command (RSCS) 107 
EXEC 2 command (CMS) 108-117 
control statements 110 
&ARGS 110 
&BEGPRINT 110 
&BEGSTACK 110 
&BEGTYPE 110 
&BUFFER 111 
&CALL 111 
&CASE 111 
&COMMAND 111 
&CRASH 111 
&DUMP 111 
&ERROR 112 
&EXIT 112 
&GOTO 112 
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&IF 112 


&LOOP 

113 

&PRESUME 113 

&PRINT 

113 

&READ 

113 

&RTURN 

114 

&SKIP 114 

&STACK 

114 

&SUBCOMMAND 

&TRACE 

114 

&TRUNC 

115 

&TYPE 

113 

&UPPER 

115 


predefined functions 115 
&CONCAT 115 
&CONCATENATION 115 
&DATATYPE 115 
&DIV 115 
&DIVISION 115 
&LEFTOF 116 
&LENGTH OF 116 
&LITERAL OF 116 
&L0CAT10N OF 116 
&MULT 116 

&MULTIPLICATION OF 116 
&PIECE 116 
&POSITION OF 116 
&RANGE OF 117 
&RIGHT OF 117 


&DEPTH 109 
&FILEMODE 109 
&FILENAME 109 
&FILETYPE 109 
&FROM 109 
&LINE.&ILINENUM 109 
&LINK 109 
&N.&INDEX 109 
&RC.&RETCODE 109 
&TIME 109 
&1 ,&2,&n 108 

user-defined functions 117 
label 117 

line-number OF 117 
EXEC 2 Interpreter 17 
EXECDROP command (CMS) 118 
EXECIO command (CMS) 119 
EXECLOAD command (CMS) 120 
EXECMAP command (CMS) 120 
EXECOS command (CMS) 121 
EXECUPDT command (CMS) 121 
EXESTAT command (CMS) 121 
EXPAND command (CMS) 122 
EXTERNAL command (CP class G) 


0 


122 


&STRING OF 117 
&SUBSTR 116 
&TRANS 117 
&TRANSLATION 117 
&TRIMOF 117 
&TYPE 115 
&WORDOF 117 
predefined variables 108 
& 108 
&0 108 

&ARGSTRING 108 
&BLANK 108 
&CMDSTRING 108 
&COMLINE 108 
&DATE 108 


F (CMS Border Command) 122 
FETCH command (CMS) 123 
FILEDEF command (CMS) 124 
FILEDEF command (GCS) 126 
FILELIST command (CMS) 126 
FINIS command (CMS) 127 
FLUSH command (CP class D) 127 
FLUSH command (RSCS) 127 
FORCE command (CP class A) 127 
FORCE command (RSCS) 128 
FORMAT command (CMS) 128 
FORMAT/ALLOCATE command (service 
aid) 129 

FREE command (CP class D) 129 


Index 289 



FREE command (RSCS) 129 
FWDSPACE command (RSCS) 130 



s 

GCS (Group Control System) Ccommands 
* 53 

ACCESS 54 
DLBL 85 
DUMPSCAN 89 
ETRACE 102 
FILEDEF 126 
GDUMP 130 
GLOBAL 132 
HX 137 

ITRACE (GCS) 142 
LOADCMD 146 
OSRUN 160 
QUERY 177 
RELEASE 181 
REPLY 182 
SET 214 

GDUMP command (GCS) 130 
GENDIRT command (CMS) 130 
GENIMAGE command (CMS) 130 
GENMOD command (CMS) 131 
GENMSG command (CMS) 131 
GEN3705 command (CMS) 131 
GET VSCREEN command (CMS) 132 
GLOBAL command (CMS) 132 
GLOBAL command (GCS) 132 
GLOBALV command (CMS) 133 
Group Control System (GCS) 

See GCS (Group Control System) 
Ccommands 

GTRACE command (RSCS) 134 


H (CMS Border Command) 134 
HALT command (CP class A) 134 
HB command (CMS) 134 
HELP command (CMS) 135 
HELPCONV command (CMS) 135 
HI command (CMS) 135 
HIDE WINDOW command (CMS) 136 
HO command (CMS) 136 
HOLD command (CP class D) 136 
HOLD command (RSCS) 136 
howtolPLCMS 16 
HT command (CMS) 136 
HX command (CMS) 137 
HX command (GCS) 137 


0 

IDENTIFY command (CMS) 137 
IMAGELIB command (CMS) 137 
IMAGEMOD command (CMS) 138 
IMMCMD command (CMS) 138 
INCLUDE command (CMS) 139 
INDICATE command (CP class A) 139 
INDICATE command (CP class E) 139 
INDICATE command (CP class G) 140 
INIT command (RSCS) 140 
input conventions 10 
Interactive Problem Control System 
See IPCS commands 
IPCS commands 
APAR 56 
CONVERT 66 
CONVIPCS EXEC 66 
DUMPSCAN 90 

+ (increment) 90 
(null line) 90 
& 90 
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&name 90 
- (decrement) 90 
? 90 

Aregs 90 
ARIOBLOK 90 
C 90 
CHain 91 
CMS 91 
CMSPoint 91 
CORtable 91 
Display 91 
DOSPoint 91 
DUMPID 91 
END 91 
FORMat 94 
G 92 
HELP 92 
HEX 94 
HX 92 
IPCSMAP 92 
Locate 92 
Locate Up 92 
MAPA 93 
Mregs 93 
MRIOBLOK 93 
OSPoint 93 
Print 93 
PRT 93 
QUIT 93 
Regs 93 
RIOblok 93 
Scroll 94 
Scrollu 94 
SYMP 94 
USERMAP 94 
VIOblok 94 
Vmblok 94 
IPCSDUMP 140 
MAP 149 


PRB 163 
PROB 164 
PRTDUMP 167 
STAT 224 

IPCS commands return codes 45 
IPCSDUMP command (IPCS) 140 
IPL command (CP class G) 140 
ITASK command (CMS) 141 
ITRACE command (GCS) 142 



L (CMS Border Command) 142 
LABELDEF command (CMS) 142 
LANGGEN command (CMS) 143 
LANGMERG command (CMS) 143 
line length 11 
line termination 11 
LINK command (CP class G) 143 
LISTDS command (CMS) 143 
LISTFILE command (CMS) 144 
LISTIO command (CMS) 144 
LKED command (CMS) 145 
LOAD command (CMS) 145 
LOADBUF command (CP class D) 146 
LOADCMD command (GCS) 146 
LOADLIB command (CMS) 146 
LOADMOD command (CMS) 146 
LOADVFCB command (CP class G) 147 
LOCATE command (CP class C,E) 147 
LOCK command (CP class A) 147 
logging off 8 
logging on 3 

logical line-editing characters 10 
logoff and security 9 
LOGOFF command (CP class any) 147 
LOGON command (CP class any) 147 
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M (CMS Border Command) 148 
MACLIB command (CMS) 148 
MAKEBUF command (CMS) 149 
MAP command (IPCS) 149 
MAXIMIZE WINDOW command (CMS) 149 
MESSAGE command (CP class A,B) 149 
MESSAGE command (CP class Any) 149 
MIGRATE command (CP class A) 150 
MINIMIZE WINDOW command (CMS) 150 
MODMAP command (CMS) 150 
MONITOR command (CP class A,E) 150 
MOREHELP command (CMS) 152 
MOVEFILE command (CMS) 152 
MSG command (RSCS) 153 
MSGNOH command (CP class A,B) 153 
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